de.tsl2.nano.util.parser

Interface IParser<INPUT>

Type Parameters:

INPUT -

All Known Implementing Classes:

BooleanOperator, ComparationOperator, ConditionOperator, Function, NumericConditionOperator, NumericOperator, Operator, Parser, SOperator, SParser

public interface IParser<INPUT>

Defines all methods to create a simple parser. the parser is independent of a type like string - so extensions are portable to other systems or languages.

Version:

$Revision$

Author:

Tom

Method Summary

Modifier and Type	Method and Description
INPUT	concat(Object... input) concatenates given elements of type INPUT
INPUT	extract(INPUT source, INPUT part) extracts the given part from source
INPUT	extract(INPUT source, INPUT match, INPUT replacement) extracts the given part from source and replaces it with replacement
boolean	isEmpty(INPUT term) isEmpty
void	replace(INPUT src, INPUT expression, INPUT replace) replace
INPUT	subElement(INPUT src, INPUT begin, INPUT end, boolean last) searches for the given block starting with begin and ending with end. if last is true, the last block will be searched.
INPUT	subEnclosing(INPUT src, INPUT begin, INPUT end) searches in src for a block starting (excluding) from first begin and ending with last end.
INPUT	trim(INPUT totrim) right and left trim
INPUT	unwrap(INPUT src) see wrap(Object).
INPUT	wrap(INPUT src) should be overridden if you need a transformation.

Method Detail

isEmpty

boolean isEmpty(INPUT term)

isEmpty

Parameters:

term - term to check

Returns:

true, if term is empty

replace

void replace(INPUT src,
             INPUT expression,
             INPUT replace)

replace

Parameters:

src -

expression -

replace -

wrap

INPUT wrap(INPUT src)

should be overridden if you need a transformation. F.e., if your INPUT is CharSequence and you need a conversion from string to stringbuilder.

Parameters:

src - source to be transformed/wrapped

Returns:

transformed/wrapped value

unwrap

INPUT unwrap(INPUT src)

see wrap(Object).

Parameters:

src - source to be re-transformed

Returns:

re-transformed/unwrapped value

extract

INPUT extract(INPUT source,
              INPUT part)

extracts the given part from source

Parameters:

source -

part -

Returns:

extracted part

extract

INPUT extract(INPUT source,
              INPUT match,
              INPUT replacement)

extracts the given part from source and replaces it with replacement

Parameters:

source -

match -

replacement -

Returns:

extracted part

subElement

INPUT subElement(INPUT src,
                 INPUT begin,
                 INPUT end,
                 boolean last)

searches for the given block starting with begin and ending with end. if last is true, the last block will be searched.

Parameters:

src - source

begin - block start

end - block end

last - whether to search from the end.

Returns:

block between begin and end. if not found, the whole source will be returned

subEnclosing

INPUT subEnclosing(INPUT src,
                   INPUT begin,
                   INPUT end)

searches in src for a block starting (excluding) from first begin and ending with last end.

Parameters:

src - source

begin - block start

end - block end

Returns:

found block or null if not found

concat

INPUT concat(Object... input)

concatenates given elements of type INPUT

Parameters:

input - input array to concatenate. the array is of type Object as a technical workaround on auto-creating an INPUT[].

Returns:

concatenation of input

trim

INPUT trim(INPUT totrim)

right and left trim

Parameters:

totrim -

Returns:

trimmed object