Spec-Zone.ru › OpenJDK 24

Класс PrintStream

java.lang.Object
java.io.OutputStream
java.io.FilterOutputStream
java.io.PrintStream
Все реализуемые интерфейсы:
Closeable, Flushable, Appendable, AutoCloseable
Прямые известные подклассы:
LogStream
public class PrintStream extends FilterOutputStream implements Appendable, Closeable
Класс PrintStream добавляет функциональность к другому потоку вывода, а именно, возможность удобного вывода представлений различных значений данных. Также предоставляются две другие функции. В отличие от других потоков вывода, класс PrintStream никогда не выбрасывает исключение IOException; вместо этого исключительные ситуации просто устанавливают внутренний флаг, который можно проверить с помощью метода checkError. При необходимости можно создать PrintStream, который будет автоматически сбрасывать буфер; это означает, что метод flush базового потока вывода будет автоматически вызываться после записи массива байтов, вызова одного из методов println, или записи символа новой строки или байта ('\n').

Все символы, выводимые классом PrintStream, преобразуются в байты с использованием заданной кодировки или набора символов, или по умолчанию, если кодировка не указана. Класс PrintWriter следует использовать в ситуациях, когда требуется запись символов, а не байтов.

Этот класс всегда заменяет некорректные и неотображаемые последовательности символов строкой замены по умолчанию для набора символов. Класс CharsetEncoder следует использовать, когда требуется больший контроль над процессом кодирования.

С:
1.0
См. также:
  • Charset.defaultCharset()

Краткое описание полей

Поля, объявленные в классе java.io.FilterOutputStream

out

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

Конструктор Описание
PrintStream(File file)
Создаёт новый поток вывода, без автоматического сброса строки, для указанного файла.
PrintStream(File file, String csn)
Создаёт новый поток вывода, без автоматического сброса строки, для указанного файла и кодировки.
PrintStream(File file, Charset charset)
Создаёт новый поток вывода, без автоматического сброса строки, для указанного файла и кодировки.
PrintStream(OutputStream out)
Создаёт новый поток вывода, без автоматического сброса строки, для указанного потока вывода.
PrintStream(OutputStream out, boolean autoFlush)
Создаёт новый поток вывода, с автоматическим сбросом строки, для указанного потока вывода.
PrintStream(OutputStream out, boolean autoFlush, String encoding)
Создаёт новый поток вывода, с автоматическим сбросом строки, для указанного потока вывода и кодировки символов.
PrintStream(OutputStream out, boolean autoFlush, Charset charset)
Создаёт новый поток вывода, с автоматическим сбросом строки, для указанного потока вывода и набора символов.
PrintStream(String fileName)
Создаёт новый поток вывода, без автоматического сброса строки, для указанного имени файла.
PrintStream(String fileName, String csn)
Создаёт новый поток вывода, без автоматического сброса строки, для указанного имени файла и кодировки.
PrintStream(String fileName, Charset charset)
Создаёт новый поток вывода, без автоматического сброса строки, для указанного имени файла и набора символов.

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

Модификатор и тип Метод Описание
PrintStream append(char c)
Добавляет указанный символ в этот поток вывода.
PrintStream append(CharSequence csq)
Добавляет указанную последовательность символов в этот поток вывода.
PrintStream append(CharSequence csq, int start, int end)
Добавляет подпоследовательность указанной последовательности символов в этот поток вывода.
Charset charset()
Возвращает набор символов, используемый в этом экземпляре класса PrintStream.
boolean checkError()
Сбрасывает поток, если он не закрыт, и проверяет состояние ошибки.
protected void clearError()
Очищает состояние ошибки этого потока.
void close()
Закрывает поток.
void flush()
Сбрасывает поток.
PrintStream format(String format, Object... args)
Записывает отформатированную строку в этот поток вывода, используя указанную строку формата и аргументы.
PrintStream format(Locale l, String format, Object... args)
Записывает отформатированную строку в этот поток вывода, используя указанную строку формата и аргументы.
void print(boolean b)
Выводит значение булевого типа.
void print(char c)
Выводит символ.
void print(char[] s)
Выводит массив символов.
void print(double d)
Выводит число с двойной точностью.
void print(float f)
Выводит число с плавающей запятой.
void print(int i)
Выводит целое число.
void print(long l)
Выводит целое число типа long.
void print(Object obj)
Выводит объект.
void print(String s)
Выводит строку.
PrintStream printf(String format, Object... args)
Удобный метод для записи отформатированной строки в этот поток вывода, используя указанную строку формата и аргументы.
PrintStream printf(Locale l, String format, Object... args)
Удобный метод для записи отформатированной строки в этот поток вывода, используя указанную строку формата и аргументы.
void println()
Завершает текущую строку, записав разделитель строк.
void println(boolean x)
Выводит значение булевого типа и затем завершает строку.
void println(char x)
Выводит символ и затем завершает строку.
void println(char[] x)
Выводит массив символов и затем завершает строку.
void println(double x)
Выводит число с двойной точностью и затем завершает строку.
void println(float x)
Выводит число с плавающей запятой и затем завершает строку.
void println(int x)
Выводит целое число и затем завершает строку.
void println(long x)
Выводит целое число типа long и затем завершает строку.
void println(Object x)
Выводит объект и затем завершает строку.
void println(String x)
Выводит строку и затем завершает строку.
protected void setError()
Устанавливает состояние ошибки потока в true.
void write(byte[] buf)
Записывает все байты из указанного массива байтов в этот поток.
void write(byte[] buf, int off, int len)
Записывает len байтов из указанного массива байтов, начиная с смещения off, в этот поток.
void write(int b)
Записывает указанный байт в этот поток.
void writeBytes(byte[] buf)
Записывает все байты из указанного массива байтов в этот поток.

Методы, объявленные в классе java.io.OutputStream

nullOutputStream

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

PrintStream

public PrintStream(OutputStream out)
Создаёт новый потоковый вывод, без автоматической очистки строки, используя указанный OutputStream. Символы, записанные в поток, преобразуются в байты с использованием кодировки по умолчанию, или, где out является PrintStream, кодировки, используемой потоком вывода.
Параметры:
out - Поток вывода, в который будут выводиться значения и объекты
См. также:
  • PrintWriter(java.io.OutputStream)
  • Charset.defaultCharset()

PrintStream

public PrintStream(OutputStream out, boolean autoFlush)
Создаёт новый потоковый вывод с указанным OutputStream и очисткой строк. Символы, записанные в поток, преобразуются в байты с использованием кодировки по умолчанию, или, где out является PrintStream, кодировки, используемой потоком вывода.
Параметры:
out - Поток вывода, в который будут выводиться значения и объекты
autoFlush - Определяет, будет ли буфер вывода очищаться всякий раз, когда записывается массив байтов, вызывается один из println методов или записывается символ новой строки или байт ('\n')
См. также:
  • PrintWriter(java.io.OutputStream, boolean)
  • Charset.defaultCharset()

PrintStream

public PrintStream(OutputStream out, boolean autoFlush, String encoding) throws UnsupportedEncodingException
Создаёт новый потоковый вывод с указанным OutputStream, очисткой строк и кодировкой символов.
Параметры:
out - Поток вывода, в который будут выводиться значения и объекты
autoFlush - Определяет, будет ли буфер вывода очищаться всякий раз, когда записывается массив байтов, вызывается один из println методов или записывается символ новой строки или байт ('\n')
encoding - Имя поддерживаемой кодировки символов
Исключения:
UnsupportedEncodingException - Если указанная кодировка не поддерживается
С:
1.4

PrintStream

public PrintStream(OutputStream out, boolean autoFlush, Charset charset)
Создаёт новый потоковый вывод с указанным OutputStream, очисткой строк и кодировкой символов. Этот конструктор по умолчанию создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы с использованием указанной кодировки.
Параметры:
out - Поток вывода, в который будут выводиться значения и объекты
autoFlush - Определяет, будет ли буфер вывода очищаться всякий раз, когда записывается массив байтов, вызывается один из println методов или записывается символ новой строки или байт ('\n')
charset - Кодировка
С:
10

PrintStream

public PrintStream(String fileName) throws FileNotFoundException
Создаёт новый потоковый вывод без автоматической очистки строк, используя указанное имя файла. Этот конструктор по умолчанию создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы с использованием кодировки по умолчанию для данной виртуальной машины Java.
Параметры:
fileName - Имя файла, используемого в качестве назначения для данного потока вывода. Если файл существует, он будет обнулён; в противном случае будет создан новый файл. Вывод будет записан в файл и буферизован.
Исключения:
FileNotFoundException - Если заданный объект файла не обозначает существующий, доступный для записи обычный файл, и новый обычный файл с этим именем не может быть создан, или если произошла какая-либо другая ошибка при открытии или создании файла
С:
1.5
См. также:
  • Charset.defaultCharset()

PrintStream

public PrintStream(String fileName, String csn) throws FileNotFoundException, UnsupportedEncodingException
Создаёт новый потоковый вывод без автоматической очистки строк, используя указанное имя файла и кодировку. Этот конструктор по умолчанию создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы с использованием указанной кодировки.
Параметры:
fileName - Имя файла, используемого в качестве назначения для данного потока вывода. Если файл существует, он будет обнулён; в противном случае будет создан новый файл. Вывод будет записан в файл и буферизован.
csn - Имя поддерживаемой кодировки
Исключения:
FileNotFoundException - Если заданный объект файла не обозначает существующий, доступный для записи обычный файл, и новый обычный файл с этим именем не может быть создан, или если произошла какая-либо другая ошибка при открытии или создании файла
UnsupportedEncodingException - Если указанная кодировка не поддерживается
С:
1.5

PrintStream

public PrintStream(String fileName, Charset charset) throws IOException
Создаёт новый потоковый вывод без автоматической очистки строк, используя указанное имя файла и кодировку. Этот конструктор по умолчанию создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы с использованием указанной кодировки.
Параметры:
fileName - Имя файла, используемого в качестве назначения для данного потока вывода. Если файл существует, он будет обнулён; в противном случае будет создан новый файл. Вывод будет записан в файл и буферизован.
charset - Кодировка
Исключения:
IOException - если произошла ошибка ввода-вывода при открытии или создании файла
С:
10

PrintStream

public PrintStream(File file) throws FileNotFoundException
Создаёт новый потоковый вывод без автоматической очистки строк, используя указанный файл. Этот конструктор по умолчанию создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы с использованием кодировки по умолчанию для данной виртуальной машины Java.
Параметры:
file - Файл, используемый в качестве назначения для данного потока вывода. Если файл существует, он будет обнулён; в противном случае будет создан новый файл. Вывод будет записан в файл и буферизован.
Исключения:
FileNotFoundException - Если заданный объект файла не обозначает существующий, доступный для записи обычный файл, и новый обычный файл с этим именем не может быть создан, или если произошла какая-либо другая ошибка при открытии или создании файла
С:
1.5
См. также:
  • Charset.defaultCharset()

PrintStream

public PrintStream(File file, String csn) throws FileNotFoundException, UnsupportedEncodingException
Создаёт новый потоковый вывод без автоматической очистки строк, используя указанный файл и кодировку. Этот конструктор по умолчанию создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы с использованием указанной кодировки.
Параметры:
file - Файл, используемый в качестве назначения для данного потока вывода. Если файл существует, он будет обнулён; в противном случае будет создан новый файл. Вывод будет записан в файл и буферизован.
csn - Имя поддерживаемой кодировки
Исключения:
FileNotFoundException - Если заданный объект файла не обозначает существующий, доступный для записи обычный файл, и новый обычный файл с этим именем не может быть создан, или если произошла какая-либо другая ошибка при открытии или создании файла
UnsupportedEncodingException - Если указанная кодировка не поддерживается
С:
1.5

PrintStream

public PrintStream(File file, Charset charset) throws IOException
Создаёт новый потоковый вывод без автоматической очистки строк, используя указанный файл и кодировку. Этот конструктор по умолчанию создаёт необходимый промежуточный OutputStreamWriter, который будет кодировать символы с использованием указанной кодировки.
Параметры:
file - Файл, используемый в качестве назначения для данного потока вывода. Если файл существует, он будет обнулён; в противном случае будет создан новый файл. Вывод будет записан в файл и буферизован.
charset - Кодировка
Исключения:
IOException - если произошла ошибка ввода-вывода при открытии или создании файла
С:
10

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

flush

public void flush()
Очищает поток. Это делается путем записи всех буферизованных байтов вывода в базовый поток вывода, а затем очищения этого потока.
Specified by:
flush in interface Flushable
Overrides:
flush in class FilterOutputStream
See Also:
  • OutputStream.flush()

close

public void close()
Закрывает поток. Это делается путем очищения потока и последующего закрытия базового потока вывода.
Specified by:
close in interface AutoCloseable
Specified by:
close in interface Closeable
Overrides:
close in class FilterOutputStream
See Also:
  • OutputStream.close()

checkError

public boolean checkError()
Очищает поток, если он не закрыт, и проверяет состояние ошибки.
Returns:
true тогда и только тогда, когда этот поток столкнулся с IOException или метод setError был вызван

setError

protected void setError()
Устанавливает состояние ошибки потока в true.

Этот метод заставит последующие вызовы checkError() возвращать true до тех пор, пока не будет вызван clearError().

Since:
1.1

clearError

protected void clearError()
Очищает состояние ошибки этого потока.

Этот метод заставит последующие вызовы checkError() возвращать false до тех пор, пока другая операция записи не завершится ошибкой и не вызовет setError().

Since:
1.6

write

public void write(int b)
Записывает указанный байт в этот поток. Если байт является символом новой строки и автоматическое очищение включено, то на базовом потоке вывода будет вызван метод flush.

Обратите внимание, что байт записывается как есть; для записи символа, который будет преобразован в соответствии с кодировкой по умолчанию, используйте методы print(char) или println(char).

Overrides:
write in class FilterOutputStream
Parameters:
b - Байт для записи
See Also:
  • print(char)
  • println(char)

write

public void write(byte[] buf, int off, int len)
Записывает len байта из указанного массива байтов, начиная со смещения off в этот поток. Если автоматическое очищение включено, то на базовом потоке вывода будет вызван метод flush.

Обратите внимание, что байты записываются как есть; для записи символов, которые будут преобразовываться в соответствии с кодировкой по умолчанию, используйте методы print(char) или println(char).

Overrides:
write in class FilterOutputStream
Parameters:
buf - Массив байтов
off - Смещение, с которого начинать взятие байтов
len - Количество байтов для записи
Throws:
IndexOutOfBoundsException - Если off отрицательно, len отрицательно или len больше, чем b.length - off
See Also:
  • FilterOutputStream.write(int)

write

public void write(byte[] buf) throws IOException
Записывает все байты из указанного массива байтов в этот поток. Если автоматическое очищение включено, то на базовом потоке вывода будет вызван метод flush.

Обратите внимание, что байты записываются как есть; для записи символов, которые будут преобразовываться в соответствии с кодировкой по умолчанию, используйте методы print(char[]) или println(char[]).

Overrides:
write in class FilterOutputStream
API Note:
Хотя объявлено, что будет выбрасывать IOException, этот метод фактически этого никогда не делает. Вместо этого, как и другие методы, которые переопределяет этот класс, он устанавливает внутренний флаг, который можно проверить с помощью метода checkError(). Для записи массива байтов без необходимости написания блока catch для IOException, используйте либо writeBytes(buf), либо write(buf, 0, buf.length).
Implementation Requirements:
Этот метод эквивалентен this.write(buf, 0, buf.length).
Parameters:
buf - Массив байтов
Throws:
IOException - Если произошла ошибка ввода-вывода.
See Also:
  • writeBytes(byte[])
  • write(byte[],int,int)

writeBytes

public void writeBytes(byte[] buf)
Записывает все байты из указанного массива байтов в этот поток. Если автоматическое очищение включено, то будет вызван метод flush.

Обратите внимание, что байты записываются как есть; для записи символов, которые будут преобразовываться в соответствии с кодировкой по умолчанию, используйте методы print(char[]) или println(char[]).

Implementation Requirements:
Этот метод эквивалентен this.write(buf, 0, buf.length).
Parameters:
buf - Массив байтов
Since:
14

print

public void print(boolean b)
Выводит булево значение. Строка, полученная из String.valueOf(boolean), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Parameters:
b - Булево значение для вывода
See Also:
  • Charset.defaultCharset()

print

public void print(char c)
Выводит символ. Символ преобразуется в один или несколько байтов в соответствии с кодировкой символов, заданной в конструкторе, или с кодировкой по умолчанию, если она не указана. Эти байты записываются точно так же, как и в методе write(int).
Parameters:
c - Символ для вывода
See Also:
  • Charset.defaultCharset()

print

public void print(int i)
Выводит целое число. Строка, полученная из String.valueOf(int), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Parameters:
i - Целое число для вывода
See Also:
  • Integer.toString(int)
  • Charset.defaultCharset()

print

public void print(long l)
Выводит длинное целое число. Строка, полученная из String.valueOf(long), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Parameters:
l - Длинное целое число для вывода
See Also:
  • Long.toString(long)
  • Charset.defaultCharset()

print

public void print(float f)
Выводит число с плавающей точкой. Строка, полученная из String.valueOf(float), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Parameters:
f - Число с плавающей точкой для вывода
See Also:
  • Float.toString(float)
  • Charset.defaultCharset()

print

public void print(double d)
Выводит число с плавающей запятой двойной точности. Строка, полученная из String.valueOf(double), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Parameters:
d - Выводимое double
See Also:
  • Double.toString(double)
  • Charset.defaultCharset()

print

public void print(char[] s)
Выводит массив символов. Символы преобразуются в байты в соответствии с кодировкой символов, заданной в конструкторе, или кодировкой по умолчанию, если она не указана. Эти байты записываются точно так же, как и в методе write(int).
Parameters:
s - Массив символов, подлежащий выводу
Throws:
NullPointerException - Если s является null
See Also:
  • Charset.defaultCharset()

print

public void print(String s)
Выводит строку. Если аргумент равен null, то печатается строка "null". В противном случае символы строки преобразуются в байты в соответствии с кодировкой символов, заданной в конструкторе, или кодировкой по умолчанию, если она не указана. Эти байты записываются точно так же, как и в методе write(int).
Parameters:
s - Печатаемая String
See Also:
  • Charset.defaultCharset()

print

public void print(Object obj)
Выводит объект. Строка, полученная из метода String.valueOf(Object), преобразуется в байты в соответствии с кодировкой по умолчанию, и эти байты записываются точно так же, как и в методе write(int).
Parameters:
obj - Выводимый Object
See Also:
  • Object.toString()
  • Charset.defaultCharset()

println

public void println()
Завершает текущую строку, записав строку разделителя строк. Строка разделителя строк определяется системной переменной line.separator и не обязательно является единственным символом новой строки ('\n').

println

public void println(boolean x)
Выводит булево значение и затем завершает строку. Этот метод работает так, как будто он вызывает print(boolean), а затем println().
Parameters:
x - Выводимое boolean

println

public void println(char x)
Выводит символ и затем завершает строку. Этот метод работает так, как будто он вызывает print(char), а затем println().
Parameters:
x - Выводимый char.

println

public void println(int x)
Выводит целое число и затем завершает строку. Этот метод работает так, как будто он вызывает print(int), а затем println().
Parameters:
x - Выводимое int.

println

public void println(long x)
Выводит целое число типа long и затем завершает строку. Этот метод работает так, как будто он вызывает print(long), а затем println().
Parameters:
x - Выводимое long.

println

public void println(float x)
Выводит число с плавающей запятой типа float и затем завершает строку. Этот метод работает так, как будто он вызывает print(float), а затем println().
Parameters:
x - Выводимое float.

println

public void println(double x)
Выводит число с плавающей запятой типа double и затем завершает строку. Этот метод работает так, как будто он вызывает print(double), а затем println().
Parameters:
x - Выводимое double.

println

public void println(char[] x)
Выводит массив символов и затем завершает строку. Этот метод работает так, как будто он вызывает print(char[]), а затем println().
Parameters:
x - массив символов для вывода.

println

public void println(String x)
Выводит строку и затем завершает строку. Этот метод работает так, как будто он вызывает print(String) и затем println().
Parameters:
x - Выводимая String.

println

public void println(Object x)
Выводит объект и затем завершает строку. Сначала вызывается String.valueOf(x) для получения строкового значения выводимого объекта, затем метод работает так, как будто он вызывает print(String) и затем println().
Parameters:
x - Выводимый Object.

printf

public PrintStream printf(String format, Object... args)
Удобный метод для записи отформатированной строки в этот поток вывода с помощью указанной строки формата и аргументов.

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

    out.format(format, args)
Parameters:
format - Строка формата, как описано в Синтаксисе строки формата
args - Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, дополнительные аргументы игнорируются. Количество аргументов является переменным и может быть нулевым. Максимальное количество аргументов ограничено максимальным размером массива Java, как определено в Спецификации виртуальной машины Java. Поведение с null аргументом зависит от преобразования.
Returns:
Этот поток вывода
Throws:
IllegalFormatException - Если строка формата содержит неверный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие недопустимые условия. Для спецификации всех возможных ошибок форматирования см. раздел Подробности в спецификации класса formatter.
NullPointerException - Если format является null
Since:
1.5

printf

public PrintStream printf(Locale l, String format, Object... args)
Удобный метод для записи отформатированной строки в этот поток вывода, используя указанную строку формата и аргументы.

Вызов этого метода в форме out.printf(l, format, args) ведет себя точно так же, как вызов

    out.format(l, format, args)
Параметры:
l - язык, который следует применять при форматировании. Если l равен null, то локализация не применяется.
format - Строка формата, как описано в синтаксисе строк формата
args - Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, дополнительные аргументы игнорируются. Количество аргументов переменное и может быть нулевым. Максимальное количество аргументов ограничено максимальным размером массива Java, определенным в Спецификации виртуальной машины Java. Поведение с null аргументом зависит от преобразования.
Возвращает:
Этот поток вывода
Исключения:
IllegalFormatException - Если строка формата содержит неправильный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие недопустимые условия. Для описания всех возможных ошибок форматирования см. раздел Подробности спецификации класса форматировщик.
NullPointerException - Если format равно null
С:
1.5

format

public PrintStream format(String format, Object... args)
Записывает отформатированную строку в этот поток вывода, используя указанную строку формата и аргументы.

Используемый язык всегда — тот, который возвращается методом Locale.getDefault(Locale.Category) со спецификацией категории FORMAT, независимо от предыдущих вызовов других методов форматирования для этого объекта.

Параметры:
format - Строка формата, как описано в синтаксисе строк формата
args - Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, дополнительные аргументы игнорируются. Количество аргументов переменное и может быть нулевым. Максимальное количество аргументов ограничено максимальным размером массива Java, определенным в Спецификации виртуальной машины Java. Поведение с null аргументом зависит от преобразования.
Возвращает:
Этот поток вывода
Исключения:
IllegalFormatException - Если строка формата содержит неправильный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие недопустимые условия. Для описания всех возможных ошибок форматирования см. раздел Подробности спецификации класса форматировщик.
NullPointerException - Если format равно null
С:
1.5

format

public PrintStream format(Locale l, String format, Object... args)
Записывает отформатированную строку в этот поток вывода, используя указанную строку формата и аргументы.
Параметры:
l - язык, который следует применять при форматировании. Если l равно null, то локализация не применяется.
format - Строка формата, как описано в синтаксисе строк формата
args - Аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, дополнительные аргументы игнорируются. Количество аргументов переменное и может быть нулевым. Максимальное количество аргументов ограничено максимальным размером массива Java, определенным в Спецификации виртуальной машины Java. Поведение с null аргументом зависит от преобразования.
Возвращает:
Этот поток вывода
Исключения:
IllegalFormatException - Если строка формата содержит неправильный синтаксис, спецификатор формата несовместим с заданными аргументами, недостаточно аргументов для строки формата или другие недопустимые условия. Для описания всех возможных ошибок форматирования см. раздел Подробности спецификации класса форматировщик.
NullPointerException - Если format равно null
С:
1.5

append

public PrintStream append(CharSequence csq)
Добавляет указанную последовательность символов в этот поток вывода.

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

    out.print(csq.toString())

В зависимости от спецификации toString для последовательности символов csq, вся последовательность может быть не добавлена. Например, вызов метода toString буфера символов вернет подпоследовательность, содержание которой зависит от позиции и предела буфера.

Определено в:
append в интерфейсе Appendable
Параметры:
csq - Последовательность символов для добавления. Если csq равно null, то в этот поток вывода добавляются четыре символа "null".
Возвращает:
Этот поток вывода
С:
1.5

append

public PrintStream append(CharSequence csq, int start, int end)
Добавляет подпоследовательность указанной последовательности символов в этот поток вывода.

Вызов этого метода в форме out.append(csq, start, end), когда csq не равно null, ведет себя точно так же, как вызов

    out.print(csq.subSequence(start, end).toString())
Определено в:
append в интерфейсе Appendable
Параметры:
csq - Последовательность символов, из которой будет взята подпоследовательность для добавления. Если csq равно null, символы будут добавлены так, как будто csq содержал четыре символа "null".
start - Индекс первого символа в подпоследовательности
end - Индекс символа, следующего за последним символом в подпоследовательности
Возвращает:
Этот поток вывода
Исключения:
IndexOutOfBoundsException - Если start или end отрицательны, start больше, чем end, или end больше, чем csq.length()
С:
1.5

append

public PrintStream append(char c)
Добавляет указанный символ в этот поток вывода.

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

    out.print(c)
Определено в:
append в интерфейсе Appendable
Параметры:
c - Символ (16-битный) для добавления
Возвращает:
Этот поток вывода
С:
1.5

charset

public Charset charset()
Возвращает кодировку символов, используемую в этом PrintStream экземпляре.
Возвращает:
кодировку символов, используемую в этом PrintStream экземпляре
С:
18

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/io/PrintStream.html

Spec-Zone.ru

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