Предопределенные потоки ввода-вывода в Java: System.in, System.out, System.err

Студент пишет int n = System.in.read();, вводит с клавиатуры 5 и получает n = 53. Следующий вызов read() возвращает 10, хотя он больше ничего не вводил. Ошибки нет: System.in отдаёт байты, а не числа — 53 это код символа '5', а 10 — перевод строки от клавиши Enter. Как устроены стандартные потоки Java и как с ними правильно работать, разберём ниже.

Предопределенные (стандартные) потоки ввода-вывода в Java — это три готовых потока, которые JVM создаёт при запуске программы и хранит в полях класса java.lang.System: System.in (стандартный ввод), System.out (стандартный вывод) и System.err (стандартный поток ошибок). Пакет java.lang импортируется автоматически, поэтому эти потоки доступны в любой программе без import и без создания объектов.

1. Класс System и три стандартных потока

Класс System из пакета java.lang хранит ссылки на три стандартных потока в полях in, out и err, объявленных как public static final. Они связаны со стандартными дескрипторами процесса 0, 1 и 2, которые операционная система по умолчанию направляет в терминал: ввод — с клавиатуры, вывод и ошибки — на экран.

Кроме потоков, System инкапсулирует и другие свойства исполняющей среды: текущее время (currentTimeMillis(), nanoTime()), системные свойства (getProperty()), переменные окружения (getenv()), разделитель строк (lineSeparator()). Создать объект System нельзя — все его члены статические.

System.in — байтовый поток ввода (его базовые методы описаны в уроке Типы байтовых потоков), System.out и System.err — байтовые потоки вывода с удобными методами печати. Общее понятие потока данных — в уроке Потоки данных в Java.

2. System.out: вывод в консоль через PrintStream

System.out — объект класса PrintStream, связанный со стандартным выводом. Запись System.out.println("Hi") читается так: у класса System берётся статическое поле out, и у этого объекта вызывается метод println(), который печатает значение и переводит строку.

Методы PrintStream превращают в текст значения любых типов и, в отличие от большинства потоков, не выбрасывают IOException: ошибка записи только выставляет внутренний флаг.

public class PrintDemo {
    public static void main(String[] args) {
        String name = "Анна";
        int age = 25;
        double score = 4.567;

        System.out.print("Имя: ");
        System.out.println(name);
        System.out.println("Возраст: " + age);
        System.out.printf("Балл: %.1f, возраст через год: %d%n", score, age + 1);
    }
}
// Вывод (русская локаль):
// Имя: Анна
// Возраст: 25
// Балл: 4,6, возраст через год: 26

JVM создаёт System.out с автоматическим сбросом буфера (autoflush), поэтому текст появляется в консоли сразу после println(), без вызова flush(). Обратная сторона — при печати сотен тысяч строк в цикле каждый вызов обращается к ОС, и вывод становится узким местом (см. FAQ). Символьный аналог PrintStream — PrintWriter, их различия разобраны в уроке Классы символьных потоков.

3. System.err: чем отличается от System.out

System.err — такой же PrintStream с теми же методами, но он пишет в отдельный канал ОС — стандартный поток ошибок (дескриптор 2). Разделение нужно, чтобы ошибки можно было отделить от полезного вывода: при перенаправлении System.out в файл сообщения System.err по-прежнему видны на экране.

public class ErrDemo {
    public static void main(String[] args) {
        System.out.println("Начало обработки");
        System.err.println("Ошибка: файл data.csv не найден");
        System.out.println("Конец обработки");
    }
}

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

java ErrDemo > out.txt
# На экране:   Ошибка: файл data.csv не найден
# В out.txt:   Начало обработки
#              Конец обработки

java ErrDemo > out.txt 2> err.txt   # вывод и ошибки в разные файлы
java ErrDemo > all.txt 2>&1         # оба потока в один файл

В System.err пишет и метод e.printStackTrace() без аргументов, поэтому трассировки исключений в IDE обычно подсвечены красным. В реальных приложениях вместо прямой печати в System.err используют логгер (java.util.logging, SLF4J + Logback), который сам решает, куда и в каком формате писать сообщения.

4. System.in: чтение с клавиатуры

System.in — байтовый поток ввода (тип InputStream), связанный со стандартным вводом. Метод System.in.read() читает один байт и возвращает его как int от 0 до 255, а в конце ввода — -1. Чтобы получить строки и числа, поток оборачивают в BufferedReader или используют Scanner.

Вызов read() блокирует программу, пока пользователь не нажмёт Enter: терминал передаёт введённую строку целиком, вместе с символом конца строки.

Пример 1. Побайтовое чтение через System.in.read()

import java.io.IOException;

public class ReadBytes {
    public static void main(String[] args) throws IOException {
        System.out.print("Введите цифру: ");
        int first = System.in.read();
        int second = System.in.read();
        System.out.println("first = " + first + ", как символ: " + (char) first
                + ", как число: " + (first - '0'));
        System.out.println("second = " + second);
    }
}
// Ввод: 5 и Enter
// Вывод (Linux, macOS):
// Введите цифру: 5
// first = 53, как символ: 5, как число: 5
// second = 10
// В Windows second = 13: Enter даёт пару \r\n, и первым приходит \r

Это и есть случай из начала урока: 53 — код символа '5', а «лишний» байт — перевод строки, который остался в потоке и достался второму вызову. Кириллица в UTF-8 занимает 2 байта на букву, поэтому побайтовое чтение подходит только для простейших случаев.

Пример 2. Чтение строк и чисел через BufferedReader

Для чтения строк System.in оборачивают в InputStreamReader (переводит байты в символы) и BufferedReader (даёт метод readLine()). Как работает этот мост и почему важна кодировка — в разделе InputStreamReader и OutputStreamWriter.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;

public class ConsoleSum {
    public static void main(String[] args) throws IOException {
        BufferedReader console = new BufferedReader(new InputStreamReader(System.in));
        System.out.print("Первое число: ");
        int a = Integer.parseInt(console.readLine().trim());
        System.out.print("Второе число: ");
        int b = Integer.parseInt(console.readLine().trim());
        System.out.println("Сумма: " + (a + b));
        // console не закрываем: вместе с ним закроется System.in
    }
}
// Ввод: 7 и 35
// Вывод:
// Первое число: 7
// Второе число: 35
// Сумма: 42
// Ввод «abc»: java.lang.NumberFormatException: For input string: "abc"
// Ctrl+D вместо ввода: readLine() вернёт null, и вызов trim() бросит NullPointerException

Если нужно разбирать ввод сразу на числа и слова (nextInt(), nextDouble()), удобнее класс Scanner — он разобран в уроке Класс Scanner.

5. Перенаправление: setIn, setOut, setErr

Стандартные потоки можно заменить прямо из программы статическими методами System.setIn(), System.setOut() и System.setErr(). После вызова весь код, который пишет в System.out или читает System.in, работает с новым потоком: файлом, буфером в памяти, сетевым соединением.

Поля in, out, err объявлены final, и присвоить им значение обычным кодом нельзя: System.out = ... не скомпилируется. Методы setXxx() меняют их через нативный код JVM — это редкое исключение из правила «final-поле не меняется».

Пример 3. Перехват вывода в строку

import java.io.ByteArrayOutputStream;
import java.io.PrintStream;

public class CaptureOutput {
    public static void main(String[] args) {
        PrintStream original = System.out;              // сохраняем, чтобы вернуть
        ByteArrayOutputStream buffer = new ByteArrayOutputStream();
        System.setOut(new PrintStream(buffer, true));
        try {
            System.out.println("Эта строка не попадёт в консоль");
        } finally {
            System.setOut(original);                    // восстанавливаем всегда
        }
        System.out.println("Перехвачено: " + buffer.toString().trim());
    }
}
// Вывод:
// Перехвачено: Эта строка не попадёт в консоль

Так проверяют в тестах методы, которые печатают результат вместо того, чтобы его возвращать. Восстановление в finally обязательно: иначе весь последующий вывод программы (и других тестов) тоже уйдёт в буфер.

Пример 4. Подмена ввода и запись ошибок в файл

import java.io.*;
import java.nio.charset.StandardCharsets;

public class RedirectDemo {
    public static void main(String[] args) throws IOException {
        System.setIn(new ByteArrayInputStream("42\n".getBytes(StandardCharsets.UTF_8)));
        BufferedReader in = new BufferedReader(new InputStreamReader(System.in, StandardCharsets.UTF_8));
        System.out.println("Прочитано: " + in.readLine());

        PrintStream originalErr = System.err;
        try (PrintStream log = new PrintStream(
                new FileOutputStream("errors.log", true), true, StandardCharsets.UTF_8)) { // Java 10+
            System.setErr(log);
            System.err.println("Это сообщение уйдёт в errors.log");
            new IllegalStateException("тест").printStackTrace(); // трассировка тоже в файл
        } finally {
            System.setErr(originalErr); // иначе System.err будет указывать на закрытый поток
        }
    }
}
// Вывод в консоль:
// Прочитано: 42
// В errors.log дописаны строка сообщения и трассировка java.lang.IllegalStateException: тест

Второй параметр FileOutputStream (true) включает дописывание в конец файла, второй параметр PrintStream (true) — autoflush. Перенаправить потоки можно и без изменения кода — средствами оболочки (>, 2>, <), как показано в разделе о System.err.

6. Что чаще всего упускают при работе с консолью

Ошибки со стандартными потоками почти всегда тихие: программа компилируется и работает, но печатает не то, что ожидалось, или перестаёт читать ввод. Большинство из них связано с тем, что System.in отдаёт байты, а вывод зависит от локали, кодировки и перегрузки метода.

Что выведет этот код?

char[] word = {'J', 'a', 'v', 'a'};
System.out.println(word);
System.out.println("Слово: " + word);
System.out.printf("%.2f%n", 3.14159);

Ответ (русская локаль):

Java
Слово: [C@1b6d3586
3,14

Первая строка вызывает перегрузку println(char[]), которая печатает символы массива. Во второй строке массив сначала участвует в конкатенации и превращается в строку через Object.toString(): [C — обозначение типа char[], после @ — хеш-код, который меняется от запуска к запуску. Исправление — "Слово: " + new String(word) или String.valueOf(word). Третья строка использует локаль по умолчанию, поэтому в русской системе разделитель дробной части — запятая, а в английской будет 3.14.