blasd.apex.core.primitive

Class Jdk9CharSequenceParsers

java.lang.Object

blasd.apex.core.primitive.Jdk9CharSequenceParsers

public class Jdk9CharSequenceParsers
extends Object

Backport from JDK9 .parse(CharSequence)

Author:

Benoit Lacelle

Constructor Summary

Constructors

Constructor and Description
Jdk9CharSequenceParsers()

Method Summary

Modifier and Type	Method and Description
static int	parseInt(CharSequence s, int beginIndex, int endIndex, int radix) Parses the CharSequence argument as a signed int in the specified radix, beginning at the specified beginIndex and extending to endIndex - 1.
static long	parseLong(CharSequence s, int beginIndex, int endIndex, int radix) Parses the CharSequence argument as a signed long in the specified radix, beginning at the specified beginIndex and extending to endIndex - 1.
static short	parseShort(CharSequence s, int beginIndex, int endIndex, int radix) Parses the string argument as a signed short in the radix specified by the second argument.

Methods inherited from class java.lang.Object

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

Constructor Detail

Jdk9CharSequenceParsers

public Jdk9CharSequenceParsers()

Method Detail

parseInt

public static int parseInt(CharSequence s,
                           int beginIndex,
                           int endIndex,
                           int radix)
                    throws NumberFormatException

Parses the CharSequence argument as a signed int in the specified radix, beginning at the specified beginIndex and extending to endIndex - 1.

The method does not take steps to guard against the CharSequence being mutated while parsing.

Parameters:

s - the CharSequence containing the int representation to be parsed

beginIndex - the beginning index, inclusive.

endIndex - the ending index, exclusive.

radix - the radix to be used while parsing s.

Returns:

the signed int represented by the subsequence in the specified radix.

Throws:

NullPointerException - if s is null.

IndexOutOfBoundsException - if beginIndex is negative, or if beginIndex is greater than endIndex or if endIndex is greater than s.length().

NumberFormatException - if the CharSequence does not contain a parsable int in the specified radix, or if radix is either smaller than Character.MIN_RADIX or larger than Character.MAX_RADIX.

Since:

9

parseLong

public static long parseLong(CharSequence s,
                             int beginIndex,
                             int endIndex,
                             int radix)
                      throws NumberFormatException

Parses the CharSequence argument as a signed long in the specified radix, beginning at the specified beginIndex and extending to endIndex - 1.

The method does not take steps to guard against the CharSequence being mutated while parsing.

Parameters:

s - the CharSequence containing the long representation to be parsed

beginIndex - the beginning index, inclusive.

endIndex - the ending index, exclusive.

radix - the radix to be used while parsing s.

Returns:

the signed long represented by the subsequence in the specified radix.

Throws:

NullPointerException - if s is null.

IndexOutOfBoundsException - if beginIndex is negative, or if beginIndex is greater than endIndex or if endIndex is greater than s.length().

NumberFormatException - if the CharSequence does not contain a parsable int in the specified radix, or if radix is either smaller than Character.MIN_RADIX or larger than Character.MAX_RADIX.

Since:

9

parseShort

public static short parseShort(CharSequence s,
                               int beginIndex,
                               int endIndex,
                               int radix)
                        throws NumberFormatException

Parses the string argument as a signed short in the radix specified by the second argument. The characters in the string must all be digits, of the specified radix (as determined by whether Character.digit(char, int) returns a nonnegative value) except that the first character may be an ASCII minus sign '-' ('\u002D') to indicate a negative value or an ASCII plus sign '+' ('\u002B') to indicate a positive value. The resulting short value is returned.

An exception of type NumberFormatException is thrown if any of the following situations occurs:

• The first argument is null or is a string of length zero.
• The radix is either smaller than Character.MIN_RADIX or larger than Character.MAX_RADIX.
• Any character of the string is not a digit of the specified radix, except that the first character may be a minus sign '-' ('\u002D') or plus sign '+' ('\u002B') provided that the string is longer than length 1.
• The value represented by the string is not a value of type short.

Parameters:

s - the String containing the short representation to be parsed

radix - the radix to be used while parsing s

Returns:

the short represented by the string argument in the specified radix.

Throws:

NumberFormatException - If the String does not contain a parsable short.