Класс Scanner

public Scanner(Readable source)

Параметры:

source — символьный источник, реализующий интерфейс Readable

public Scanner(InputStream source)

Параметры:

source — входной поток для сканирования

См. также:

• Charset.defaultCharset()

public Scanner(InputStream source, String charsetName)

Параметры:

source — входной поток для сканирования

charsetName — тип кодировки, используемой для преобразования байтов потока в символы для сканирования

Исключения:

IllegalArgumentException — если указанная кодировка символов не существует

public Scanner(InputStream source, Charset charset)

Параметры:

source — входной поток для сканирования

charset — кодировка, используемая для преобразования байтов файла в символы для сканирования

Начиная с версии:

10

public Scanner(File source) throws FileNotFoundException

Параметры:

source — файл для сканирования

Исключения:

FileNotFoundException — если источник не найден

См. также:

• Charset.defaultCharset()

public Scanner(File source, String charsetName) throws FileNotFoundException

Параметры:

source — файл для сканирования

charsetName — тип кодировки, используемой для преобразования байтов файла в символы для сканирования

Исключения:

FileNotFoundException — если источник не найден

IllegalArgumentException — если указанная кодировка не найдена

public Scanner(File source, Charset charset) throws IOException

Параметры:

source — файл для сканирования

charset — кодировка, используемая для преобразования байтов файла в символы для сканирования

Исключения:

IOException — если при открытии источника возникает ошибка ввода-вывода

Начиная с версии:

10

public Scanner(Path source) throws IOException

Параметры:

source — путь к файлу для сканирования

Исключения:

IOException — если при открытии источника возникает ошибка ввода-вывода

Начиная с версии:

1.7

См. также:

• Charset.defaultCharset()

public Scanner(Path source, String charsetName) throws IOException

Параметры:

source — путь к файлу для сканирования

charsetName — тип кодировки, используемой для преобразования байтов файла в символы для сканирования

Исключения:

IOException — если при открытии источника возникает ошибка ввода-вывода

IllegalArgumentException — если указанная кодировка не найдена

Начиная с версии:

1.7

public Scanner(Path source, Charset charset) throws IOException

Параметры:

source — путь к файлу для сканирования

charset — кодировка, используемая для преобразования байтов файла в символы для сканирования

Исключения:

IOException — если при открытии источника возникает ошибка ввода-вывода

Начиная с версии:

10

public Scanner(String source)

Параметры:

source — строка для сканирования

public Scanner(ReadableByteChannel source)

Параметры:

source — канал для сканирования

См. также:

• Charset.defaultCharset()

public Scanner(ReadableByteChannel source, String charsetName)

Параметры:

source — канал для сканирования

charsetName — тип кодировки, используемой для преобразования байтов канала в символы для сканирования

Исключения:

IllegalArgumentException — если указанная кодировка символов не существует

public Scanner(ReadableByteChannel source, Charset charset)

Параметры:

source — канал для сканирования

charset — тип кодировки, используемой для преобразования байтов канала в символы для сканирования

Начиная с версии:

10

public void close()

Определен в:

close в интерфейсе AutoCloseable

Определен в:

close в интерфейсе Closeable

public IOException ioException()

Возвращает:

последнее исключение, возникшее в источнике для чтения этого сканера

public Pattern delimiter()

Возвращает:

шаблон разделителей этого сканера.

public Scanner useDelimiter(Pattern pattern)

Параметры:

pattern — шаблон разделителей

Возвращает:

этот сканер

public Scanner useDelimiter(String pattern)

Параметры:

pattern — строка, задающая шаблон разделителей

Возвращает:

этот сканер

public Locale locale()

Возвращает:

локаль этого сканера

public Scanner useLocale(Locale locale)

Параметры:

locale — строка, задающая используемую локаль

Возвращает:

этот сканер

public int radix()

Возвращает:

система счисления по умолчанию этого сканера

public Scanner useRadix(int radix)

Параметры:

radix — система счисления для сканирования чисел

Возвращает:

этот сканер

Исключения:

IllegalArgumentException — если система счисления выходит за допустимые пределы

public MatchResult match()

Возвращает:

результат последней операции сопоставления

Исключения:

IllegalStateException — если результат сопоставления недоступен

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этого сканера

public boolean hasNext()

Определен в:

hasNext в интерфейсе Iterator<String>

Возвращает:

true тогда и только тогда, когда у этого сканера есть следующий токен

Исключения:

IllegalStateException — если этот сканер закрыт

См. также:

• Iterator

public String next()

Определен в:

next в интерфейсе Iterator<String>

Возвращает:

следующий токен

Исключения:

NoSuchElementException — если больше нет доступных токенов

IllegalStateException — если этот сканер закрыт

См. также:

• Iterator

public void remove()

Определен в:

remove в интерфейсе Iterator<String>

Исключения:

UnsupportedOperationException — если вызван этот метод.

См. также:

• Iterator

public boolean hasNext(String pattern)

Параметры:

pattern — строка, задающая шаблон для поиска

Возвращает:

true тогда и только тогда, когда у этого сканера есть другой токен, соответствующий указанному шаблону

Исключения:

IllegalStateException — если этот сканер закрыт

public String next(String pattern)

Параметры:

pattern — строка, задающая шаблон для поиска

Возвращает:

следующий токен

Исключения:

NoSuchElementException — если таких токенов нет

IllegalStateException — если этот сканер закрыт

public boolean hasNext(Pattern pattern)

Параметры:

pattern — шаблон для поиска

Возвращает:

true тогда и только тогда, когда у этого сканера есть другой токен, соответствующий указанному шаблону

Исключения:

IllegalStateException — если этот сканер закрыт

public String next(Pattern pattern)

Параметры:

pattern — шаблон для поиска

Возвращает:

следующий токен

Исключения:

NoSuchElementException — если больше нет доступных токенов

IllegalStateException — если этот сканер закрыт

public boolean hasNextLine()

Возвращает:

true, если в оставшихся входных данных есть разделитель строк или другие символы

Исключения:

IllegalStateException — если этот сканер закрыт

public String nextLine()

Возвращает:

пропущенная строка

Исключения:

NoSuchElementException — если строка не найдена

IllegalStateException — если этот сканер закрыт

public String findInLine(String pattern)

Параметры:

pattern — строка, задающая шаблон для поиска

Возвращает:

текст, соответствующий указанному шаблону

Исключения:

IllegalStateException — если этот сканер закрыт

public String findInLine(Pattern pattern)

Параметры:

pattern — шаблон для поиска

Возвращает:

текст, соответствующий указанному шаблону

Исключения:

IllegalStateException — если этот сканер закрыт

public String findWithinHorizon(String pattern, int horizon)

Параметры:

pattern — строка, задающая шаблон для поиска

horizon — горизонт поиска

Возвращает:

текст, соответствующий указанному шаблону

Исключения:

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если горизонт отрицателен

public String findWithinHorizon(Pattern pattern, int horizon)

Параметры:

pattern — шаблон для поиска

horizon — горизонт поиска

Возвращает:

текст, соответствующий указанному шаблону

Исключения:

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если горизонт отрицателен

public Scanner skip(Pattern pattern)

Параметры:

pattern — шаблон для пропуска

Возвращает:

этот сканер

Исключения:

NoSuchElementException — если указанный шаблон не найден

IllegalStateException — если этот сканер закрыт

public Scanner skip(String pattern)

Параметры:

pattern — строка, задающая шаблон для пропуска

Возвращает:

этот сканер

Исключения:

IllegalStateException — если этот сканер закрыт

public boolean hasNextBoolean()

Возвращает:

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

Исключения:

IllegalStateException — если этот сканер закрыт

public boolean nextBoolean()

Возвращает:

логическое значение, считанное из входных данных

Исключения:

InputMismatchException — если следующий токен не является допустимым логическим значением

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

public boolean hasNextByte()

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

public boolean hasNextByte(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена как значения типа byte

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public byte nextByte()

Возвращает:

значение byte, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

public byte nextByte(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена как значения типа byte

Возвращает:

значение byte, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public boolean hasNextShort()

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

public boolean hasNextShort(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена как значения типа short

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public short nextShort()

Возвращает:

значение short, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

public short nextShort(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена как значения типа short

Возвращает:

значение short, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public boolean hasNextInt()

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

public boolean hasNextInt(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена как значения типа int

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public int nextInt()

Возвращает:

значение int, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

public int nextInt(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена как значения типа int

Возвращает:

значение int, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public boolean hasNextLong()

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

public boolean hasNextLong(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена как значения типа long

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public long nextLong()

Возвращает:

значение long, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

public long nextLong(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена как значения типа int

Возвращает:

значение long, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public boolean hasNextFloat()

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

public float nextFloat()

Возвращает:

значение float, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Float или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

public boolean hasNextDouble()

Возвращает:

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

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

public double nextDouble()

Возвращает:

значение double, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Float или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

public boolean hasNextBigInteger()

Возвращает:

true тогда и только тогда, когда следующий токен этого сканера является допустимым BigInteger

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

public boolean hasNextBigInteger(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена как целого числа

Возвращает:

true тогда и только тогда, когда следующий токен этого сканера является допустимым BigInteger

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public BigInteger nextBigInteger()

Возвращает:

значение BigInteger, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

public BigInteger nextBigInteger(int radix)

Параметры:

radix — основание системы счисления, используемое для интерпретации токена

Возвращает:

значение BigInteger, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Integer или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

IllegalArgumentException — если основание системы счисления вне допустимого диапазона

public boolean hasNextBigDecimal()

Возвращает:

true тогда и только тогда, когда следующий токен этого сканера является допустимым BigDecimal

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

public BigDecimal nextBigDecimal()

Возвращает:

значение BigDecimal, считанное из входных данных

Вызывает исключение:

InputMismatchException — если следующий токен не соответствует регулярному выражению Decimal или выходит за допустимый диапазон

NoSuchElementException — если входные данные исчерпаны

IllegalStateException — если этот сканер закрыт

public Scanner reset()

Возвращает:

этот сканер

Начиная с версии:

1.6

public Stream<String> tokens()

Примечание API:

Например, следующий код создаст список токенов, разделённых запятыми, из строки:

List<String> result = new Scanner("abc,def,,ghi")
    .useDelimiter(",")
    .tokens()
    .collect(Collectors.toList());

Полученный список будет содержать "abc", "def", пустую строку и "ghi".

Возвращает:

последовательный поток строковых токенов

Вызывает исключение:

IllegalStateException — если этот сканер закрыт

Начиная с версии:

9

public Stream<MatchResult> findAll(Pattern pattern)

Примечание к API:

Например, следующий код прочитает файл и вернёт список всех последовательностей символов, состоящих из семи или более заглавных латинских букв:

try (Scanner sc = new Scanner(Path.of("input.txt"))) {
    Pattern pat = Pattern.compile("[A-Z]{7,}");
    List<String> capWords = sc.findAll(pat)
                              .map(MatchResult::group)
                              .collect(Collectors.toList());
}

Параметры:

pattern — шаблон для поиска

Возвращает:

последовательный поток результатов совпадений

Выбрасывает:

NullPointerException — если шаблон равен null

IllegalStateException — если этот сканер закрыт

Начиная с версии:

9

public Stream<MatchResult> findAll(String patString)

    scanner.findAll(Pattern.compile(patString))

Параметры:

patString — строка шаблона

Возвращает:

последовательный поток результатов совпадений

Выбрасывает:

NullPointerException — если patString равен null

IllegalStateException — если этот сканер закрыт

PatternSyntaxException — если синтаксис регулярного выражения некорректен

Начиная с версии:

9

См. также:

• Pattern