Класс 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