Scanner JDK 1.6)

Hide/Show inherited methods

public void close ()

Closes this scanner.

public Pattern delimiter ()

Returns the Pattern this Scanner is currently using to match delimiters.

Returns the Pattern this Scanner is currently
using to match delimiters.
Returns: this scanner's delimiting pattern.

public String findInLine (Pattern pattern)

Attempts to find the next occurrence of the specified pattern ignoring delimiters.

Attempts to find the next occurrence of the specified pattern ignoring delimiters. If the pattern is found before the next line separator, the scanner advances past the input that matched and returns the string that matched the pattern. If no such pattern is detected in the input up to the next line separator, then null is returned and the scanner's position is unchanged. This method may block waiting for input that matches the pattern.

Since this method continues to search through the input looking for the specified pattern, it may buffer all of the input searching for the desired token if no line separators are present.
Returns: the text that matched the specified pattern
Parameters:
- pattern - the pattern to scan for
Throws:
- IllegalStateException - if this scanner is closed

public String findInLine (String pattern)

Attempts to find the next occurrence of a pattern constructed from the specified string, ignoring delimiters.

public String findWithinHorizon (Pattern pattern, int horizon)

Attempts to find the next occurrence of the specified pattern.

public String findWithinHorizon (String pattern, int horizon)

Attempts to find the next occurrence of a pattern constructed from the specified string, ignoring delimiters.

public boolean hasNext () [Specified in Iterator]

Returns true if this scanner has another token in its input.

public boolean hasNext (Pattern pattern)

Returns true if the next complete token matches the specified pattern.

public boolean hasNext (String pattern)

Returns true if the next token matches the pattern constructed from the specified string.

public boolean hasNextBigDecimal ()

Returns true if the next token in this scanner's input can be interpreted as a BigDecimal using the Scanner.nextBigDecimal() method.

Returns true if the next token in this scanner's input can be
interpreted as a BigDecimal using the
Scanner.nextBigDecimal() method. The scanner does not advance past any
input.
Returns: true if and only if this scanner's next token is a valid BigDecimal
Throws:
- IllegalStateException - if this scanner is closed

public boolean hasNextBigInteger ()

Returns true if the next token in this scanner's input can be interpreted as a BigInteger in the default radix using the Scanner.nextBigInteger() method.

Returns true if the next token in this scanner's input can be
interpreted as a BigInteger in the default radix using the
Scanner.nextBigInteger() method. The scanner does not advance past any
input.
Returns: true if and only if this scanner's next token is a valid BigInteger
Throws:
- IllegalStateException - if this scanner is closed

public boolean hasNextBigInteger (int radix)

Returns true if the next token in this scanner's input can be interpreted as a BigInteger in the specified radix using the Scanner.nextBigInteger() method.

Returns true if the next token in this scanner's input can be
interpreted as a BigInteger in the specified radix using
the Scanner.nextBigInteger() method. The scanner does not advance past
any input.
Returns: true if and only if this scanner's next token is a valid BigInteger
Parameters:
- radix - the radix used to interpret the token as an integer
Throws:
- IllegalStateException - if this scanner is closed

public boolean hasNextBoolean ()

Returns true if the next token in this scanner's input can be interpreted as a boolean value using a case insensitive pattern created from the string "true|false".

public boolean hasNextByte ()

Returns true if the next token in this scanner's input can be interpreted as a byte value in the default radix using the Scanner.nextByte() method.

public boolean hasNextByte (int radix)

Returns true if the next token in this scanner's input can be interpreted as a byte value in the specified radix using the Scanner.nextByte() method.

public boolean hasNextDouble ()

Returns true if the next token in this scanner's input can be interpreted as a double value using the Scanner.nextDouble() method.

public boolean hasNextFloat ()

Returns true if the next token in this scanner's input can be interpreted as a float value using the Scanner.nextFloat() method.

public boolean hasNextInt ()

Returns true if the next token in this scanner's input can be interpreted as an int value in the default radix using the Scanner.nextInt() method.

public boolean hasNextInt (int radix)

Returns true if the next token in this scanner's input can be interpreted as an int value in the specified radix using the Scanner.nextInt() method.

public boolean hasNextLine ()

Returns true if there is another line in the input of this scanner.

public boolean hasNextLong ()

Returns true if the next token in this scanner's input can be interpreted as a long value in the default radix using the Scanner.nextLong() method.

public boolean hasNextLong (int radix)

Returns true if the next token in this scanner's input can be interpreted as a long value in the specified radix using the Scanner.nextLong() method.

public boolean hasNextShort ()

Returns true if the next token in this scanner's input can be interpreted as a short value in the default radix using the Scanner.nextShort() method.

public boolean hasNextShort (int radix)

Returns true if the next token in this scanner's input can be interpreted as a short value in the specified radix using the Scanner.nextShort() method.

public IOException ioException ()

Returns the IOException last thrown by this Scanner's underlying Readable.

Returns the IOException last thrown by this
Scanner's underlying Readable. This method
returns null if no such exception exists.
Returns: the last exception thrown by this scanner's readable

public Locale locale ()

Returns this scanner's locale.

public MatchResult match ()

Returns the match result of the last scanning operation performed by this scanner.

Returns the match result of the last scanning operation performed by this scanner. This method throws IllegalStateException if no match has been performed, or if the last match was not successful.

The various nextmethods of Scanner make a match result available if they complete without throwing an exception. For instance, after an invocation of the Scanner.nextInt() method that returned an int, this method returns a MatchResult for the search of the Integer regular expression defined above. Similarly the Scanner.findInLine(java.lang.String), Scanner.findWithinHorizon(java.lang.String, int), and Scanner.skip(java.util.regex.Pattern) methods will make a match available if they succeed.
Returns: a match result for the last match operation
Throws:
- IllegalStateException - If no match result is available

public String next () [Specified in Iterator]

Finds and returns the next complete token from this scanner.

Finds and returns the next complete token from this scanner.
A complete token is preceded and followed by input that matches
the delimiter pattern. This method may block while waiting for input
to scan, even if a previous invocation of Scanner.hasNext() returned
true.
Returns: the next token
Throws:
- NoSuchElementException - if no more tokens are available
- IllegalStateException - if this scanner is closed
See Also: Iterator,

public String next (Pattern pattern)

Returns the next token if it matches the specified pattern.

Returns the next token if it matches the specified pattern. This
method may block while waiting for input to scan, even if a previous
invocation of Scanner.hasNext(Pattern) returned true.
If the match is successful, the scanner advances past the input that
matched the pattern.
Returns: the next token
Parameters:
- pattern - the pattern to scan for
Throws:
- NoSuchElementException - if no more tokens are available
- IllegalStateException - if this scanner is closed

public String next (String pattern)

Returns the next token if it matches the pattern constructed from the specified string.

public BigDecimal nextBigDecimal ()

Scans the next token of the input as a BigDecimal.

public BigInteger nextBigInteger ()

Scans the next token of the input as a BigInteger.

public BigInteger nextBigInteger (int radix)

Scans the next token of the input as a BigInteger.

public boolean nextBoolean ()

Scans the next token of the input into a boolean value and returns that value.

Scans the next token of the input into a boolean value and returns
that value. This method will throw InputMismatchException
if the next token cannot be translated into a valid boolean value.
If the match is successful, the scanner advances past the input that
matched.
Returns: the boolean scanned from the input
Throws:
- InputMismatchException - if the next token is not a valid boolean
- NoSuchElementException - if input is exhausted
- IllegalStateException - if this scanner is closed

public byte nextByte ()

Scans the next token of the input as a byte.

public byte nextByte (int radix)

Scans the next token of the input as a byte.

Scans the next token of the input as a byte. This method will throw InputMismatchException if the next token cannot be translated into a valid byte value as described below. If the translation is successful, the scanner advances past the input that matched.

If the next token matches the Integer regular expression defined above then the token is converted into a byte value as if by removing all locale specific prefixes, group separators, and locale specific suffixes, then mapping non-ASCII digits into ASCII digits via Character.digit, prepending a negative sign (-) if the locale specific negative prefixes and suffixes were present, and passing the resulting string to Byte.parseByte with the specified radix.
Returns: the byte scanned from the input
Parameters:
- radix - the radix used to interpret the token as a byte value
Throws:
- InputMismatchException - if the next token does not match the Integer regular expression, or is out of range
- NoSuchElementException - if input is exhausted
- IllegalStateException - if this scanner is closed

public double nextDouble ()

Scans the next token of the input as a double.

Scans the next token of the input as a double. This method will throw InputMismatchException if the next token cannot be translated into a valid double value. If the translation is successful, the scanner advances past the input that matched.

If the next token matches the Float regular expression defined above then the token is converted into a double value as if by removing all locale specific prefixes, group separators, and locale specific suffixes, then mapping non-ASCII digits into ASCII digits via Character.digit, prepending a negative sign (-) if the locale specific negative prefixes and suffixes were present, and passing the resulting string to Double.parseDouble. If the token matches the localized NaN or infinity strings, then either "Nan" or "Infinity" is passed to Double.parseDouble as appropriate.
Returns: the double scanned from the input
Throws:
- InputMismatchException - if the next token does not match the Float regular expression, or is out of range
- NoSuchElementException - if the input is exhausted
- IllegalStateException - if this scanner is closed

public float nextFloat ()

Scans the next token of the input as a float.

Scans the next token of the input as a float. This method will throw InputMismatchException if the next token cannot be translated into a valid float value as described below. If the translation is successful, the scanner advances past the input that matched.

If the next token matches the Float regular expression defined above then the token is converted into a float value as if by removing all locale specific prefixes, group separators, and locale specific suffixes, then mapping non-ASCII digits into ASCII digits via Character.digit, prepending a negative sign (-) if the locale specific negative prefixes and suffixes were present, and passing the resulting string to Float.parseFloat. If the token matches the localized NaN or infinity strings, then either "Nan" or "Infinity" is passed to Float.parseFloat as appropriate.
Returns: the float scanned from the input
Throws:
- InputMismatchException - if the next token does not match the Float regular expression, or is out of range
- NoSuchElementException - if input is exhausted
- IllegalStateException - if this scanner is closed

public int nextInt ()

Scans the next token of the input as an int.

public int nextInt (int radix)

Scans the next token of the input as an int.

Scans the next token of the input as an int. This method will throw InputMismatchException if the next token cannot be translated into a valid int value as described below. If the translation is successful, the scanner advances past the input that matched.

If the next token matches the Integer regular expression defined above then the token is converted into an int value as if by removing all locale specific prefixes, group separators, and locale specific suffixes, then mapping non-ASCII digits into ASCII digits via Character.digit, prepending a negative sign (-) if the locale specific negative prefixes and suffixes were present, and passing the resulting string to Integer.parseInt with the specified radix.
Returns: the int scanned from the input
Parameters:
- radix - the radix used to interpret the token as an int value
Throws:
- InputMismatchException - if the next token does not match the Integer regular expression, or is out of range
- NoSuchElementException - if input is exhausted
- IllegalStateException - if this scanner is closed

public String nextLine ()

Advances this scanner past the current line and returns the input that was skipped.

public long nextLong ()

Scans the next token of the input as a long.

public long nextLong (int radix)

Scans the next token of the input as a long.

Scans the next token of the input as a long. This method will throw InputMismatchException if the next token cannot be translated into a valid long value as described below. If the translation is successful, the scanner advances past the input that matched.

If the next token matches the Integer regular expression defined above then the token is converted into a long value as if by removing all locale specific prefixes, group separators, and locale specific suffixes, then mapping non-ASCII digits into ASCII digits via Character.digit, prepending a negative sign (-) if the locale specific negative prefixes and suffixes were present, and passing the resulting string to Long.parseLong with the specified radix.
Returns: the long scanned from the input
Parameters:
- radix - the radix used to interpret the token as an int value
Throws:
- InputMismatchException - if the next token does not match the Integer regular expression, or is out of range
- NoSuchElementException - if input is exhausted
- IllegalStateException - if this scanner is closed

public short nextShort ()

Scans the next token of the input as a short.

public short nextShort (int radix)

Scans the next token of the input as a short.

Scans the next token of the input as a short. This method will throw InputMismatchException if the next token cannot be translated into a valid short value as described below. If the translation is successful, the scanner advances past the input that matched.

If the next token matches the Integer regular expression defined above then the token is converted into a short value as if by removing all locale specific prefixes, group separators, and locale specific suffixes, then mapping non-ASCII digits into ASCII digits via Character.digit, prepending a negative sign (-) if the locale specific negative prefixes and suffixes were present, and passing the resulting string to Short.parseShort with the specified radix.
Returns: the short scanned from the input
Parameters:
- radix - the radix used to interpret the token as a short value
Throws:
- InputMismatchException - if the next token does not match the Integer regular expression, or is out of range
- NoSuchElementException - if input is exhausted
- IllegalStateException - if this scanner is closed

public int radix ()

Returns this scanner's default radix.

public void remove () [Specified in Iterator]

The remove operation is not supported by this implementation of Iterator.

The remove operation is not supported by this implementation of
Iterator.
Throws:
- UnsupportedOperationException - if this method is invoked.
See Also: Iterator,

public Scanner reset ()

Resets this scanner.

public Scanner skip (Pattern pattern)

Skips input that matches the specified pattern, ignoring delimiters.

public Scanner skip (String pattern)

Skips input that matches a pattern constructed from the specified string.

public String toString ()

Returns the string representation of this Scanner.

public Scanner useDelimiter (Pattern pattern)

Sets this scanner's delimiting pattern to the specified pattern.

public Scanner useDelimiter (String pattern)

Sets this scanner's delimiting pattern to a pattern constructed from the specified String.

An invocation of this method of the form useDelimiter(pattern) behaves in exactly the same way as the invocation useDelimiter(Pattern.compile(pattern)).

Invoking the Scanner.reset() method will set the scanner's delimiter to the default.
Returns: this scanner
Parameters:
- pattern - A string specifying a delimiting pattern

public Scanner useLocale (Locale locale)

Sets this scanner's locale to the specified locale.

public Scanner useRadix (int radix)

Sets this scanner's default radix to the specified radix.

LocalGroupSeparator	The character used to separate thousands groups, i.e., `dfs.getGroupingSeparator()`
LocalDecimalSeparator	The character used for the decimal point, i.e., `dfs.getDecimalSeparator()`
LocalPositivePrefix	The string that appears before a positive number (may be empty), i.e., `df.getPositivePrefix()`
LocalPositiveSuffix	The string that appears after a positive number (may be empty), i.e., `df.getPositiveSuffix()`
LocalNegativePrefix	The string that appears before a negative number (may be empty), i.e., `df.getNegativePrefix()`
LocalNegativeSuffix	The string that appears after a negative number (may be empty), i.e., `df.getNegativeSuffix()`
LocalNaN	The string that represents not-a-number for floating-point values, i.e., `dfs.getNaN()`
LocalInfinity	The string that represents infinity for floating-point values, i.e., `dfs.getInfinity()`

Localized numbers

Number syntax