de.tsl2.nano.util.parser

Class SParser

java.lang.Object

de.tsl2.nano.util.parser.Parser<CharSequence>

de.tsl2.nano.util.parser.SParser

All Implemented Interfaces:

IParser<CharSequence>

Direct Known Subclasses:

Function

public class SParser
extends Parser<CharSequence>

Simple text parser as extension of generic parser Parser.

Version:

$Revision$

Author:

Tom

Constructor Summary

Constructors

Constructor and Description
SParser()

Method Summary

Modifier and Type	Method and Description
CharSequence	concat(Object... input) concatenates given elements of type INPUT
CharSequence	extract(CharSequence source, CharSequence match, CharSequence replacement) extracts the given part from source and replaces it with replacement
void	replace(CharSequence src, CharSequence expression, CharSequence replace) replace
CharSequence	subElement(CharSequence src, CharSequence begin, CharSequence 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.
CharSequence	subEnclosing(CharSequence src, CharSequence begin, CharSequence end) searches in src for a block starting (excluding) from first begin and ending with last end.
CharSequence	trim(CharSequence totrim) right and left trim
CharSequence	unwrap(CharSequence src) see Parser.wrap(Object).
CharSequence	wrap(CharSequence src) should be overridden if you need a transformation.

Methods inherited from class de.tsl2.nano.util.parser.Parser

extract, isEmpty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SParser

public SParser()

Method Detail

replace

public void replace(CharSequence src,
                    CharSequence expression,
                    CharSequence replace)

Description copied from interface: IParser

replace

extract

public CharSequence extract(CharSequence source,
                            CharSequence match,
                            CharSequence replacement)

Description copied from interface: IParser

extracts the given part from source and replaces it with replacement

Returns:

extracted part

subElement

public CharSequence subElement(CharSequence src,
                               CharSequence begin,
                               CharSequence end,
                               boolean last)

Description copied from interface: IParser

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

public CharSequence subEnclosing(CharSequence src,
                                 CharSequence begin,
                                 CharSequence end)

Description copied from interface: IParser

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

public CharSequence concat(Object... input)

Description copied from interface: IParser

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

wrap

public CharSequence wrap(CharSequence src)

Description copied from class: Parser

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

Specified by:

wrap in interface IParser<CharSequence>

Overrides:

wrap in class Parser<CharSequence>

Parameters:

src - source to be transformed/wrapped

Returns:

transformed/wrapped value

unwrap

public CharSequence unwrap(CharSequence src)

Description copied from class: Parser

see Parser.wrap(Object).

Specified by:

unwrap in interface IParser<CharSequence>

Overrides:

unwrap in class Parser<CharSequence>

Parameters:

src - source to be re-transformed

Returns:

re-transformed/unwrapped value

trim

public CharSequence trim(CharSequence totrim)

right and left trim

Returns:

trimmed object