Класс Scanner

public final class Scanner
extends Object
implements Iterator<String>, Closeable

Простой текстовый сканер, который может анализировать примитивные типы и строки с использованием регулярных выражений.

Сканер разбивает свой ввод на токены, используя шаблон разделителя, который по умолчанию соответствует пробелам. Полученные токены затем могут быть преобразованы в значения разных типов с помощью различных методов.

Например, этот код позволяет пользователю читать число из потока:

Scanner sc = new Scanner(System.in);
int i = sc.nextInt();

В качестве другого примера, этот код позволяет назначать значения разных типов из записей в файле:

Scanner sc = new Scanner(new File("myNumbers"));
while (sc.hasNextLong()) {
    long aLong = sc.nextLong();
}

Сканер также может использовать разделители, отличные от пробелов. Этот пример считывает несколько элементов из строки:

String input = "1 fish 2 fish red fish blue fish";
Scanner s = new Scanner(input).useDelimiter("\\s*fish\\s*");
System.out.println(s.nextInt());
System.out.println(s.nextInt());
System.out.println(s.next());
System.out.println(s.next());
s.close();

выводит следующий вывод:

1
2
red
blue

Тот же вывод можно получить с помощью этого кода, который использует регулярное выражение для анализа всех четырех токенов сразу:

String input = "1 fish 2 fish red fish blue fish";
Scanner s = new Scanner(input);
s.findInLine("(\\d+) fish (\\d+) fish (\\w+) fish (\\w+)");
MatchResult result = s.match();
for (int i=1; i<=result.groupCount(); i++)
    System.out.println(result.group(i));
s.close();

Разделитель по умолчанию (пробелы) используемый сканером, определяется с помощью метода Character.isWhitespace(). Метод reset() сбросит значение разделителя сканера на значение по умолчанию (пробелы) независимо от того, было ли оно ранее изменено.

Операция сканирования может блокироваться, ожидая ввода.

Методы next() и hasNext(), а также связанные методы (например, nextInt() и hasNextInt()) сначала пропускают любой ввод, соответствующий шаблону разделителя, а затем пытаются вернуть следующий токен. Оба метода могут блокироваться, ожидая дополнительного ввода. Блокирование метода сканирования не связано с блокированием сопутствующего метода проверки наличия следующего токена. Метод tokens() также может блокироваться, ожидая ввода.

Методы findInLine(), findWithinHorizon(), skip() и findAll() работают независимо от шаблона разделителя. Эти методы попытаются сопоставить указанный шаблон без учета разделителей во вводе и, таким образом, могут быть использованы в особых случаях, когда разделители не имеют значения. Эти методы могут блокироваться, ожидая большего ввода.

Когда сканер выбрасывает исключение InputMismatchException, сканер не пройдет токен, вызвавший исключение, чтобы его можно было получить или пропустить с помощью другого метода.

В зависимости от типа разделительного шаблона могут возвращаться пустые токены. Например, шаблон "\\s+" не вернёт пустых токенов, так как он соответствует нескольким вхождениям разделителя. Шаблон разделителя "\\s" может возвращать пустые токены, так как он пропускает только один пробел за раз.

Сканер может считывать текст из любого объекта, реализующего интерфейс Readable. Если вызов метода read() базового объекта-читателя вызывает исключение IOException, сканер предполагает, что конец ввода достигнут. Последнее исключение, сгенерированное базовым объектом-читателем, можно получить с помощью метода ioException().

При закрытии сканера, он закроет источник ввода, если источник реализует интерфейс Closeable.

Сканер не является потокобезопасным без внешней синхронизации.

Если не указано иное, передача параметра null в любой метод сканера вызовет исключение NullPointerException.

Сканер по умолчанию интерпретирует числа как десятичные, пока не будет задано другое основание с помощью метода useRadix(int). Метод reset() сбросит значение основания сканера до 10 независимо от того, было ли оно ранее изменено.

Локализованные числа

Экземпляр этого класса может сканировать числа в стандартных форматах, а также в форматах локали сканера. Начальная локали сканера — значение, возвращаемое методом Locale.getDefault(Locale.Category.FORMAT); она может быть изменена с помощью метода useLocale(). Метод reset() сбросит значение локали сканера до начальной локали независимо от того, было ли оно ранее изменено.

Локализованные форматы определяются с помощью следующих параметров, которые для определенной локали берутся из объекта DecimalFormat этой локали, df, и его объекта DecimalFormatSymbols, dfs.

Разделитель групп

Символ, используемый для разделения групп тысяч, т.е., dfs.getGroupingSeparator()

Десятичный разделитель

Символ, используемый для десятичной точки, т.е., dfs.getDecimalSeparator()

Положительный префикс

Строка, появляющаяся перед положительным числом (может быть пустой), т.е., df.getPositivePrefix()

Положительный суффикс

Строка, появляющаяся после положительного числа (может быть пустой), т.е., df.getPositiveSuffix()

Отрицательный префикс

Строка, появляющаяся перед отрицательным числом (может быть пустой), т.е., df.getNegativePrefix()

Отрицательный суффикс

Строка, появляющаяся после отрицательного числа (может быть пустой), т.е., df.getNegativeSuffix()

NaN

Строка, представляющая не число для значений с плавающей точкой, т.е., dfs.getNaN()

Бесконечность

Строка, представляющая бесконечность для значений с плавающей точкой, т.е., dfs.getInfinity()

Синтаксис чисел

Строки, которые могут быть распарсены как числа экземпляром этого класса, определяются в терминах следующей грамматики регулярных выражений, где Rmax — это наибольшая цифра в используемом основании (например, Rmax — 9 в основании 10).

НеASCII-цифра:

Не-ASCII символ c, для которого Character.isDigit(c) возвращает true

Не0-цифра:

[1-Rmax] | НеASCII-цифра

Цифра:

[0-Rmax] | НеASCII-цифра

Группа чисел:

( Не0-цифра Цифра? Цифра?

( Разделитель групп Цифра Цифра Цифра )+ )

Число:

( ( Цифра+ ) | Группа чисел )

Целое число:

( [-+]? ( Число ) )

| Положительный префикс Число Положительный суффикс

| Отрицательный префикс Число Отрицательный суффикс

Десятичное число:

Число

| Число Десятичный разделитель Цифра*

| Десятичный разделитель Цифра+

Показатель степени:

( [eE] [+-]? Цифра+ )

Десятичное число:

( [-+]? Десятичное число Показатель степени? )

| Положительный префикс Десятичное число Положительный суффикс Показатель степени?

| Отрицательный префикс Десятичное число Отрицательный суффикс Показатель степени?

Шестнадцатеричное число с плавающей точкой:

[-+]? 0[xX][0-9a-fA-F]*\.[0-9a-fA-F]+ ([pP][-+]?[0-9]+)?

Не число:

NaN | NaN | Infinity | Бесконечность

Отрицательное не число:

( [-+]? Не число )

| Положительный префикс Не число Положительный суффикс

| Отрицательный префикс Не число Отрицательный суффикс

Число с плавающей точкой:

Десятичное число | Шестнадцатеричное число с плавающей точкой | Отрицательное не число

Пробелы не имеют значения в вышеприведенных регулярных выражениях.