Class list

public static boolean CLEAR

Setting to true means that the list nodes must always be connected by the same operation. This is far safer and clearer, but not required by default standard.

public final node[] nodes

A list of nodes.

public list(char binary_operator,
            char unary_operator,
            node[] a_nodes)

Creates a new model list that is a member of some enclosing list.

Parameters:

binary_operator - An operator with that this list is connected with other members of the enclosing list.

unary_operator - The unary operator for this list.

a_nodes - The nodes inside this list.

public list(node[] a_nodes)
            throws Error

Creates a new model list. Assigns the previous field.

Parameters:

a_nodes - The nodes for this list.

protected void close()

Closes all members in the list.

Overrides:

close in interface node

protected boolean compare(Object a_token)

Compare given token with the token of this node. If the token represents a list, the call may be delegeted to the child subnodes.

Overrides:

compare in interface node

Parameters:

a_token - A token to compare.

Returns:

True if the token matches the token of this node.

public Object findFreeNode()

Find the token that could match as the next token in the token list.

Overrides:

findFreeNode in interface node

Returns:

Such token object or null if none is found.

public boolean isClosed()

Returns true if all members in the list are closed.

Overrides:

isClosed in interface node

public boolean matches(Object[] tokens)

Tries to match this list agains the given token sequence.

Parameters:

tokens - the sequence of the tokens to match.

Returns:

true if the valid match is found.

public boolean mustClose()

The list never closes, despite it is trated as closed if all members in the list are closed.

Overrides:

mustClose in interface node

Returns:

false.

public boolean performMatch(Object token)

Perform a match operation for the single token against this list.

Overrides:

performMatch in interface node

Parameters:

token - a token to match.

Returns:

true if the match is found.

public void reset()

Prepeares the list for the next matching operation.

Overrides:

reset in interface node

public Object show(Object x)

Check if the provided token can match as a next token in the list. In the case of match, the list state changes, moving current position after the matched token. However if this method returns a suggested new token to insert before the provided one, the state of the list does not change.

Overrides:

show in interface node

Returns:

Boolean.TRUE if the match is found, Boolean.FALSE if the match is not possible and no token can be inserted to make the match valid. Otherwise, returns the token object that can be inserted before the last token in the list, probably (not for sure) making the match valid. If the object is an instance of Element or TagElement, it is first ensured that the object flag "omit start" is set.

public String toString()

Returns a string representation of the list.

Overrides:

toString in interface node

Returns:

String representation, similar to BNF expression.

public boolean valid()

Returns true if all memebers in the list are valid.

Overrides:

valid in interface node

public boolean validPreliminary()

Returns true if all memebers in the list are either valid or unvisited. The unvisited members can become valid after more tokens will be shown.

Overrides:

validPreliminary in interface node