Module io.github.mmm.scanner

Package io.github.mmm.scanner.number

Class CharScannerNumberParserLang

java.lang.Object

io.github.mmm.scanner.number.CharScannerNumberParserBase

io.github.mmm.scanner.number.CharScannerNumberParserLang

All Implemented Interfaces:

CharScannerNumberParser, CharScannerRadixHandler

public class CharScannerNumberParserLang
extends CharScannerNumberParserBase

CharScannerNumberParser to parse java.lang Number values such as Long, Integer, Double or Float.

Nested Class Summary

Nested classes/interfaces inherited from class io.github.mmm.scanner.number.CharScannerNumberParserBase

CharScannerNumberParserBase.CharScannerNumberSpecial, CharScannerNumberParserBase.CharScannerNumberSpecialDelimiter, CharScannerNumberParserBase.CharScannerNumberSpecialNonNumber

Field Summary

Fields inherited from class io.github.mmm.scanner.number.CharScannerNumberParserBase

builder, digitsLeadingZeros, digitsTotal, digitsTrailingZeros, dotPosition, error, exponentDigitsLeadingZeros, exponentDigitsTotal, exponentSign, exponentSymbol, INFINITY, NAN, openDelimiter, radix, radixChar, sign

Constructor Summary

Constructors

Constructor	Description
CharScannerNumberParserLang(CharScannerRadixHandler radixMode, NumberType<?> numberType)	The constructor.
CharScannerNumberParserLang(CharScannerRadixHandler radixMode, NumberType<?> numberType, String delimiters)	The constructor.
CharScannerNumberParserLang(CharScannerRadixHandler radixMode, NumberType<?> numberType, String delimiters, long maxNonDecimal)	The constructor.

Method Summary

Modifier and Type	Method	Description
Double	asDouble()
Integer	asInteger()
Long	asLong()
protected StringBuilder	builder()
boolean	digit(int digit, char digitChar)
protected boolean	isDecimal()
protected void	resetTrailingZeros()	Resets the trailing zeros if a non zero digit was found for mantissa.
boolean	sign(char signChar)	This method will only be called if the first character if the number is '+' or '-'.
void	special(String special)
String	toString()

Methods inherited from class io.github.mmm.scanner.number.CharScannerNumberParserBase

appendExponent, appendRadix, dot, exponent, isDigit, isValidDelimiterPosition, radix, special, specials

Methods inherited from class java.lang.Object

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

Constructor Details

CharScannerNumberParserLang

public CharScannerNumberParserLang(CharScannerRadixHandler radixMode,
 NumberType<?> numberType)

The constructor.

Parameters:

radixMode - the CharScannerRadixHandler for CharScannerNumberParserBase.radix(int, char).

numberType - the NumberType.

CharScannerNumberParserLang

public CharScannerNumberParserLang(CharScannerRadixHandler radixMode,
 NumberType<?> numberType,
 String delimiters)

The constructor.

Parameters:

radixMode - the CharScannerRadixHandler for CharScannerNumberParserBase.radix(int, char).

numberType - the NumberType.

delimiters - the accepted delimiter characters.

CharScannerNumberParserLang

public CharScannerNumberParserLang(CharScannerRadixHandler radixMode,
 NumberType<?> numberType,
 String delimiters,
 long maxNonDecimal)

The constructor.

Parameters:

radixMode - the CharScannerRadixHandler for CharScannerNumberParserBase.radix(int, char).

numberType - the NumberType.

delimiters - the accepted delimiter characters.

maxNonDecimal - the maximum allowed number (e.g. Integer.MAX_VALUE to parse an Integer value).

Method Details

isDecimal

protected boolean isDecimal()

Specified by:

isDecimal in class CharScannerNumberParserBase

Returns:

true in case decimal numbers with CharScannerNumberParserBase.dot() and/or exponent are accepted, false otherwise.

sign

public boolean sign(char signChar)

Description copied from interface: CharScannerNumberParser

This method will only be called if the first character if the number is '+' or '-'.

Specified by:

sign in interface CharScannerNumberParser

Overrides:

sign in class CharScannerNumberParserBase

Parameters:

signChar - '+' for positive number and '-' for negative number. If no sign is present this method will never be called.

Returns:

true if the sign shall be accepted and further characters shall be received, false to prevent consuming the sign or any further characters and abort the process (e.g. to parse only positive numbers without any sign).

special

public void special(String special)

Specified by:

special in interface CharScannerNumberParser

Overrides:

special in class CharScannerNumberParserBase

Parameters:

special - the special String that was found and consumed.

See Also:

• CharScannerNumberParser.special(char)

builder

protected StringBuilder builder()

Overrides:

builder in class CharScannerNumberParserBase

Returns:

the StringBuilder to build the number. Ensures initialization in case of lazy-init.

digit

public boolean digit(int digit,
 char digitChar)

Specified by:

digit in interface CharScannerNumberParser

Overrides:

digit in class CharScannerNumberParserBase

Parameters:

digit - the parsed digitChar as numeric digit to "append". Will never be negative but may be greater or equal to the radix returned by CharScannerRadixHandler.radix(int, char) as NumberFormatException has to be handled inside the receiver.

digitChar - the original digit character. In case the number shall be received as String this makes your life simpler and allows to preserve the case.

Returns:

true if the given digit is accepted, false otherwise (exceeds the range of the number to parse and the digit should not be consumed). Typical implementations should always return true.

resetTrailingZeros

protected void resetTrailingZeros()

Description copied from class: CharScannerNumberParserBase

Resets the trailing zeros if a non zero digit was found for mantissa.

Overrides:

resetTrailingZeros in class CharScannerNumberParserBase

asInteger

public Integer asInteger()

Returns:

the parsed value as Integer.

Throws:

NumberFormatException - if parsing failed.

asLong

public Long asLong()

Returns:

the parsed value as Long.

Throws:

NumberFormatException - if parsing failed.

asDouble

public Double asDouble()

Returns:

the parsed value as Double.

Throws:

NumberFormatException - if parsing failed.

toString

public String toString()

Overrides:

toString in class CharScannerNumberParserBase