Класс Scanner

Если этот сканер ещё не закрыт, то если его базовый readable также реализует интерфейс Closeable, то метод close базового readable будет вызван. Если этот сканер уже закрыт, вызов этого метода не повлияет.

Попытка выполнить операции поиска после закрытия сканера приведёт к исключению IllegalStateException.

Вызов этого метода в форме useDelimiter(pattern) ведет себя точно так же, как вызов useDelimiter(Pattern.compile(pattern)).

Вызов метода reset() установит разделитель сканера на значение по умолчанию.

Локаль сканера влияет на многие элементы его стандартных регулярных выражений для примитивного сопоставления; см. локализованные числа выше.

Локаль сканера влияет на многие элементы его стандартных регулярных выражений для примитивного сопоставления; см. локализованные числа выше.

Вызов метода reset() установит локаль сканера на начальную локаль.

Основание системы счисления сканера влияет на элементы его стандартных регулярных выражений для сопоставления чисел; см. локализованные числа выше.

Основание системы счисления сканера влияет на элементы его стандартных регулярных выражений для сопоставления чисел; см. локализованные числа выше.

Если основание меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то выбрасывается IllegalArgumentException.

Вызов метода reset() установит основание системы счисления сканера на 10.

Различные next методы Scanner делают результат сопоставления доступным, если они завершаются без исключений. Например, после вызова метода nextInt(), который возвращает int, этот метод возвращает результат MatchResult для поиска регулярного выражения Integer, определённого выше. Аналогично методы findInLine(), findWithinHorizon() и skip() сделают результат сопоставления доступным, если они завершатся успешно.

Возвращает строковое представление этого Scanner. Строковое представление Scanner содержит информацию, которая может быть полезна для отладки. Точный формат не определён.

Вызов этого метода в форме hasNext(pattern) ведет себя точно так же, как вызов hasNext(Pattern.compile(pattern)).

Вызов этого метода в форме next(pattern) ведет себя точно так же, как вызов next(Pattern.compile(pattern)).

Поскольку этот метод продолжает поиск во входных данных, ища разделитель строк, он может буферизовать все входные данные, ища строку для пропуска, если разделители строк отсутствуют.

Вызов этого метода в форме findInLine(pattern) ведет себя точно так же, как вызов findInLine(Pattern.compile(pattern)).

Поскольку этот метод продолжает поиск по вводу, ища указанный шаблон, он может буферизовать весь вход, ища нужный токен, если разделителей строк нет.

Вызов этого метода в форме findWithinHorizon(pattern) ведет себя точно так же, как вызов findWithinHorizon(Pattern.compile(pattern), horizon).

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

Сканер никогда не будет искать более horizon символов за пределами своей текущей позиции. Обратите внимание, что совпадение может быть ограничено горизонтом; то есть произвольный результат совпадения мог быть другим, если бы горизонт был больше. Сканер обрабатывает горизонт как прозрачную, не привязанную к началу границу (см. Matcher.useTransparentBounds(boolean) и Matcher.useAnchoringBounds(boolean)).

Если горизонт 0, то горизонт игнорируется, и этот метод продолжает поиск по вводу, ища указанный шаблон без ограничений. В этом случае он может буферизовать весь вход, ища шаблон.

Если горизонт отрицательный, выбрасывается исключение IllegalArgumentException.

Если совпадение указанного шаблона не найдено в текущей позиции, то вход не пропускается и выбрасывается исключение NoSuchElementException.

Поскольку этот метод пытается сопоставить указанный шаблон, начиная с текущей позиции сканера, шаблоны, которые могут соответствовать большому количеству ввода (например, ".*"), могут привести к буферизации большого объема ввода.

Обратите внимание, что можно пропустить что-либо, не рискуя получить NoSuchElementException, используя шаблон, который не может ничего сопоставить, например, sc.skip("[ \t]*").

Вызов этого метода в форме skip(pattern) ведет себя точно так же, как вызов skip(Pattern.compile(pattern)).

Если система счисления меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то выбрасывается исключение IllegalArgumentException.

Вызов этого метода в форме nextByte() ведет себя точно так же, как вызов nextByte(radix), где radix является стандартной системой счисления этого сканера.

Если следующий токен соответствует регулярному выражению Integer, определенному выше, то токен преобразуется в значение типа byte так, как если бы все локальные префиксы, разделители групп и локальные суффиксы были удалены, затем не-ASCII цифры были преобразованы в ASCII цифры с помощью Character.digit, перед этим был префиксный знак «-», если присутствовали локальные префиксы и суффиксы отрицательных значений, и полученная строка была передана в Byte.parseByte с указанной системой счисления.

Если система счисления меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то выбрасывается исключение IllegalArgumentException.

Если радикс меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то выбрасывается IllegalArgumentException.

Вызов этого метода в форме nextShort() ведет себя точно так же, как вызов nextShort(radix), где radix - это значение по умолчанию для радикса этого сканера.

Если следующий токен соответствует регулярному выражению Integer, определенному выше, то токен преобразуется в значение типа short так, как если бы все локально-зависимые префиксы, разделители групп и локально-зависимые суффиксы были удалены, не-ASCII цифры были преобразованы в ASCII цифры с помощью Character.digit, префикс "-" добавлялся, если присутствовали локально-зависимые префиксы и суффиксы отрицательных значений, и полученная строка передавалась в Short.parseShort с указанным радиксом.

Если радикс меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то выбрасывается IllegalArgumentException.

Если радикс меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то выбрасывается IllegalArgumentException.

Вызов этого метода в форме nextInt() ведет себя точно так же, как вызов nextInt(radix), где radix - это значение по умолчанию для радикса этого сканера.

Если следующий токен соответствует регулярному выражению Integer, определенному выше, то токен преобразуется в значение типа int так, как если бы все локально-зависимые префиксы, разделители групп и локально-зависимые суффиксы были удалены, не-ASCII цифры были преобразованы в ASCII цифры с помощью Character.digit, префикс "-" добавлялся, если присутствовали локально-зависимые префиксы и суффиксы отрицательных значений, и полученная строка передавалась в Integer.parseInt с указанным радиксом.

Если радикс меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то выбрасывается IllegalArgumentException.

Если радикс меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то выбрасывается IllegalArgumentException.

Вызов этого метода в форме nextLong() ведет себя точно так же, как вызов nextLong(radix), где radix - это значение по умолчанию для радикса этого сканера.

Если следующий токен соответствует регулярному выражению Целое число, определённому выше, то токен преобразуется в значение long, как если бы все локализованные префиксы, разделители групп и суффиксы были удалены, а не-ASCII цифры были преобразованы в ASCII цифры с помощью Character.digit, перед префиксом отрицательного знака (-) в случае присутствия локализованных префиксов и суффиксов, и полученная строка передаётся в Long.parseLong со значением заданного радикса.

Если радикс меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то будет выброшено IllegalArgumentException.

Если следующий токен соответствует регулярному выражению Число с плавающей точкой, определённому выше, то токен преобразуется в значение float, как если бы все локализованные префиксы, разделители групп и суффиксы были удалены, а не-ASCII цифры были преобразованы в ASCII цифры с помощью Float.parseFloat, перед префиксом отрицательного знака (-) в случае присутствия локализованных префиксов и суффиксов, и полученная строка передаётся в Float.parseFloat. Если токен соответствует локализованным строкам NaN или бесконечности, то "Nan" или "Infinity" соответственно передаются в Float.parseFloat.

Если следующий токен соответствует регулярному выражению Число с плавающей точкой, определённому выше, то токен преобразуется в значение double, как если бы все локализованные префиксы, разделители групп и суффиксы были удалены, а не-ASCII цифры были преобразованы в ASCII цифры с помощью Character.digit, перед префиксом отрицательного знака (-) в случае присутствия локализованных префиксов и суффиксов, и полученная строка передаётся в Double.parseDouble. Если токен соответствует локализованным строкам NaN или бесконечности, то "Nan" или "Infinity" соответственно передаются в Double.parseDouble.

Если радикс меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то будет выброшено IllegalArgumentException.

Вызов этого метода в форме nextBigInteger() ведёт себя точно так же, как вызов nextBigInteger(radix), где radix - это радикс по умолчанию этого сканера.

Если следующий токен соответствует регулярному выражению Целое число, определённому выше, то токен преобразуется в значение BigInteger как если бы все разделители групп были удалены, а не-ASCII цифры были преобразованы в ASCII цифры с помощью Character.digit, и полученная строка передана в конструктор BigInteger(String, int) со значением указанного радикса.

Если радикс меньше Character.MIN_RADIX или больше Character.MAX_RADIX, то будет выброшено IllegalArgumentException.

Если следующий токен соответствует регулярному выражению Десятичное число, определённому выше, то токен преобразуется в значение BigDecimal как если бы все разделители групп были удалены, а не-ASCII цифры были преобразованы в ASCII цифры с помощью Character.digit, и полученная строка передана в конструктор BigDecimal(String).

Сброс сканера отбрасывает всю его явную информацию о состоянии, которая могла быть изменена вызовами useDelimiter(), useLocale() или useRadix().

Вызов этого метода в форме scanner.reset() ведет себя точно так же, как вызов

   scanner.useDelimiter("\\p{javaWhitespace}+")
          .useLocale(Locale.getDefault(Locale.Category.FORMAT))
          .useRadix(10);
 

Полученный поток является последовательным и упорядоченным. Все элементы потока не равны null.

Сканирование начинается при инициировании терминальной операции потока, используя текущее состояние этого сканера. Последующие вызовы любых методов этого сканера, кроме close() и ioException(), могут вернуть неопределенные результаты или вызвать неопределенные эффекты на возвращаемом потоке. Источник возвращаемого потока Spliterator является быстропроверяемым и, по возможности, бросит исключение ConcurrentModificationException, если такие вызовы будут обнаружены во время выполнения потоковой обработки.

После завершения выполнения потоковой обработки этот сканер остается в неопределенном состоянии и не может быть повторно использован.

Если этот сканер содержит ресурс, который необходимо освободить, этот сканер должен быть закрыт, либо вызвав его метод close(), либо закрыв возвращаемый поток. Закрытие потока закроет базовый сканер. IllegalStateException выбрасывается, если сканер был закрыт при вызове этого метода или если этот сканер закрывается во время выполнения потоковой обработки.

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

Полученный поток является последовательным и упорядоченным. Все элементы потока не равны null.

Сканирование начинается при инициировании терминальной операции потока, используя текущее состояние этого сканера. Последующие вызовы любых методов этого сканера, кроме close() и ioException(), могут вернуть неопределенные результаты или вызвать неопределенные эффекты на возвращаемом потоке. Источник возвращаемого потока Spliterator является быстропроверяемым и, по возможности, бросит исключение ConcurrentModificationException, если такие вызовы будут обнаружены во время выполнения потоковой обработки.

После завершения выполнения потоковой обработки этот сканер остается в неопределенном состоянии и не может быть повторно использован.

Если этот сканер содержит ресурс, который необходимо освободить, этот сканер должен быть закрыт, либо вызвав его метод close(), либо закрыв возвращаемый поток. IllegalStateException выбрасывается, если сканер был закрыт при вызове этого метода или если этот сканер закрывается во время выполнения потоковой обработки.

Как и методы findWithinHorizon(), этот метод может блокироваться, ожидая дополнительного ввода, и может буферизовать неограниченное количество ввода, ища соответствие.

     scanner.findAll(Pattern.compile(patString))