Package app.babylon.text

Interface SliceParser<T>

Type Parameters:

T - the parsed value type

All Superinterfaces:

Function<CharSequence,T>

All Known Subinterfaces:

TypeParser<T>

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface SliceParser<T>
extends Function<CharSequence,T>

Parses a slice of character data without requiring callers to materialize a String or create a CharSequence view first.

Any method with the same shape can bind directly as a method reference. For example, Currencys.parse(CharSequence, int, int) can be used wherever a SliceParser<Currency> is expected:

 Currency currency = Sentence.firstIn(Currencys::parse, "pay USD 120 tomorrow");
 

Method Summary

Modifier and Type	Method	Description
default T	apply(CharSequence s)
static <T> SliceParser<T>	from(Function<CharSequence,T> parser)	Adapts an existing whole-sequence parser.
default T	parse(CharSequence s)	Parses the whole character sequence.
T	parse(CharSequence s, int start, int end)	Parses a slice of s.

Methods inherited from interface java.util.function.Function

andThen, compose

Method Details

parse

T parse(CharSequence s,
 int start,
 int end)

Parses a slice of s.

Parameters:

s - the source characters

start - the first character in the slice

end - one past the last character in the slice

Returns:

the parsed value, or null when parsing fails

parse

default T parse(CharSequence s)

Parses the whole character sequence.

apply

default T apply(CharSequence s)

Specified by:

apply in interface Function<CharSequence,T>

from

static <T> SliceParser<T> from(Function<CharSequence,T> parser)

Adapts an existing whole-sequence parser. This compatibility path may create a CharSequence.subSequence(int, int) view for sliced inputs; parsers that can consume start/end bounds directly should implement parse(CharSequence, int, int) instead.