Spec-Zone.ru › OpenJDK 27

Класс IO

java.lang.Object
java.lang.IO
public final class IO extends Object
Набор статических методов, обеспечивающих удобный доступ к System.in и System.out для построчного ввода и вывода.

Методы readln() и readln(String) декодируют байты, прочитанные из System.in, в символы. Кодировка, используемая для декодирования, задается свойством stdin.encoding. Если это свойство отсутствует или указанную в нем кодировку невозможно загрузить, вместо нее используется UTF-8. При декодировании некорректные и неподдающиеся отображению последовательности байтов всегда заменяются строкой замены кодировки по умолчанию.

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

Примечание об API:
Предполагается, что некоторые приложения будут использовать для чтения из стандартного ввода только методы readln и не будут смешивать эти вызовы с другими способами чтения из System.in.
Начиная с версии:
25

Краткое описание методов

Модификатор и тип Метод Описание
static void print(Object obj)
Записывает строковое представление указанного объекта в стандартный вывод.
static void println()
Записывает разделитель строк в стандартный вывод.
static void println(Object obj)
Записывает строковое представление указанного объекта, а затем разделитель строк в стандартный вывод.
static String readln()
Считывает одну строку текста из стандартного ввода.
static String readln(String prompt)
Выводит приглашение, а затем считывает строку ввода.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли этот объект некоторому другому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API может быть удален в будущей версии.
Финализация устарела и будет удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

Подробное описание методов

println

public static void println(Object obj)
Записывает строковое представление указанного объекта, а затем разделитель строк в стандартный вывод.

Результат такой же, как если бы для System.out был вызван метод println(obj).

Параметры:
obj — объект для вывода; может быть null

println

public static void println()
Записывает разделитель строк в стандартный вывод.

Результат такой же, как если бы для System.out был вызван метод println().

print

public static void print(Object obj)
Записывает строковое представление указанного объекта в стандартный вывод.

Результат такой же, как если бы для System.out был вызван метод print(obj).

Параметры:
obj — объект для вывода; может быть null

readln

public static String readln()
Считывает одну строку текста из стандартного ввода.

Одна строка считывается из декодированного ввода так же, как при вызове BufferedReader.readLine(), после чего возвращается результат.

При необходимости этот метод сначала настраивает декодирование символов, как описано выше в спецификации класса.

Возвращает:
строку, содержащую считанную из стандартного ввода строку без символов-разделителей строк. Возвращает null, если достигнут конец потока и не было считано ни одного символа.
Выбрасывает:
IOError — если произошла ошибка ввода-вывода

readln

public static String readln(String prompt)
Выводит приглашение, а затем считывает строку ввода.

Выводит приглашение так же, как при вызове print, а затем считывает одну строку текста так же, как при вызове readln.

При необходимости этот метод сначала настраивает декодирование символов, как описано выше в спецификации класса.

Параметры:
prompt — строка приглашения; может быть null
Возвращает:
строку, содержащую считанную из стандартного ввода строку без символов-разделителей строк. Возвращает null, если достигнут конец потока и не было считано ни одного символа.
Выбрасывает:
IOError — если произошла ошибка ввода-вывода

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API