Spec-Zone.ru › OpenJDK 25

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

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

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

out

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

Конструктор Описание
PrintStream(File file)
Создает новый поток печати без автоматической очистки буфера при переходе на новую строку для указанного файла.
PrintStream(File file, String csn)
Создает новый поток печати без автоматической очистки буфера при переходе на новую строку для указанного файла и набора символов.
PrintStream(File file, Charset charset)
Создает новый поток печати без автоматической очистки буфера при переходе на новую строку для указанного файла и набора символов.
PrintStream(OutputStream out)
Создает новый поток печати без автоматической очистки буфера для указанного OutputStream.
PrintStream(OutputStream out, boolean autoFlush)
Создает новый поток печати для указанного OutputStream с автоматической очисткой буфера при переходе на новую строку.
PrintStream(OutputStream out, boolean autoFlush, String encoding)
Создает новый поток печати для указанного OutputStream с автоматической очисткой буфера при переходе на новую строку и заданной кодировкой символов.
PrintStream(OutputStream out, boolean autoFlush, Charset charset)
Создает новый поток печати для указанного OutputStream с автоматической очисткой буфера при переходе на новую строку и заданным набором символов.
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)
Выводит длинное целое число.
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)
Выводит число double, а затем завершает строку.
void println(float x)
Выводит число float, а затем завершает строку.
void println(int x)
Выводит целое число, а затем завершает строку.
void println(long x)
Выводит длинное целое число, а затем завершает строку.
void println(Object x)
Выводит объект Object, а затем завершает строку.
void println(String x)
Выводит строку String, а затем завершает строку.
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)
Записывает в этот поток все байты из указанного массива байтов.

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

nullOutputStream

Методы, объявленные в классе 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()
Сбрасывает поток. Для этого все байты буферизованного вывода записываются в базовый выходной поток, после чего этот поток сбрасывается.
Определено в:
flush в интерфейсе Flushable
Переопределяет:
flush в классе FilterOutputStream
См. также:
  • OutputStream.flush()

close

public void close()
Закрывает поток. Для этого поток сбрасывается, после чего закрывается базовый выходной поток.
Определено в:
close в интерфейсе AutoCloseable
Определено в:
close в интерфейсе Closeable
Переопределяет:
close в классе FilterOutputStream
См. также:
  • OutputStream.close()

checkError

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

setError

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

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

С версии:
1.1

clearError

protected void clearError()
Сбрасывает состояние ошибки этого потока.

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

С версии:
1.6

write

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

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

Переопределяет:
write в классе FilterOutputStream
Параметры:
b — записываемый байт
См. также:
  • print(char)
  • println(char)

write

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

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

Переопределяет:
write в классе FilterOutputStream
Параметры:
buf — массив байтов
off — смещение, с которого следует начинать чтение байтов
len — количество байтов для записи
Исключения:
IndexOutOfBoundsException — если off отрицательно, len отрицательно или len больше, чем b.length - off
См. также:
  • FilterOutputStream.write(int)

write

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

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

Переопределяет:
write в классе FilterOutputStream
Примечание API:
Хотя объявлено, что метод выбрасывает IOException, фактически этого никогда не происходит. Вместо этого, как и другие переопределяемые этим классом методы, он устанавливает внутренний флаг, значение которого можно проверить с помощью метода checkError(). Чтобы записать массив байтов, не записывая блок catch для IOException, используйте writeBytes(buf) или write(buf, 0, buf.length).
Требования к реализации:
Этот метод эквивалентен this.write(buf, 0, buf.length).
Параметры:
buf — массив байтов
Исключения:
IOException — если возникает ошибка ввода-вывода.
См. также:
  • writeBytes(byte[])
  • write(byte[],int,int)

writeBytes

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

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

Требования к реализации:
Этот метод эквивалентен this.write(buf, 0, buf.length).
Параметры:
buf — массив байтов
С версии:
14

print

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

print

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

print

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

print

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

print

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

print

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

print

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

print

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

print

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

println

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

println

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

println

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

println

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

println

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

println

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

println

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

println

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

println

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

println

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

printf

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

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

    out.format(format, args)
Параметры:
format — строка формата, описанная в разделе Синтаксис строки формата
args — аргументы, на которые ссылаются спецификаторы формата в строке формата. Если аргументов больше, чем спецификаторов формата, лишние аргументы игнорируются. Количество аргументов может быть переменным, в том числе равным нулю. Максимальное количество аргументов ограничено максимальным размером массива Java, определенным в Спецификации виртуальной машины Java. Поведение при аргументе null зависит от преобразования.
Возвращает:
этот поток вывода
Исключения:
IllegalFormatException — если строка формата содержит недопустимый синтаксис, спецификатор формата несовместим с заданными аргументами, для строки формата задано недостаточно аргументов или возникли другие недопустимые условия. Описание всех возможных ошибок форматирования см. в разделе Подробное описание спецификации класса форматирования.
NullPointerException — если format равен null
Начиная с версии:
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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/io/PrintStream.html

Spec-Zone.ru

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