Module java.base
Package java.io

Class PrintStream

  • All Implemented Interfaces:
    Closeable, Flushable, Appendable, AutoCloseable
    Direct Known Subclasses:
    LogStream
    public class PrintStream
extends FilterOutputStream
implements Appendable, Closeable
    A PrintStream adds functionality to another output stream, namely the ability to print representations of various data values conveniently. Two other features are provided as well. Unlike other output streams, a PrintStream never throws an IOException; instead, exceptional situations merely set an internal flag that can be tested via the checkError method. Optionally, a PrintStream can be created so as to flush automatically; this means that the flush method is automatically invoked after a byte array is written, one of the println methods is invoked, or a newline character or byte ('\n') is written.

    All characters printed by a PrintStream are converted into bytes using the given encoding or charset, or platform's default character encoding if not specified. The PrintWriter class should be used in situations that require writing characters rather than bytes.

    This class always replaces malformed and unmappable character sequences with the charset's default replacement string. The CharsetEncoder class should be used when more control over the encoding process is required.

    Since:
    1.0

    • Constructor Summary

      Constructors
      Constructor Description
      PrintStream​(File file)
      Creates a new print stream, without automatic line flushing, with the specified file.
      PrintStream​(File file, String csn)
      Creates a new print stream, without automatic line flushing, with the specified file and charset.
      PrintStream​(File file, Charset charset)
      Creates a new print stream, without automatic line flushing, with the specified file and charset.
      PrintStream​(OutputStream out)
      Creates a new print stream.
      PrintStream​(OutputStream out, boolean autoFlush)
      Creates a new print stream.
      PrintStream​(OutputStream out, boolean autoFlush, String encoding)
      Creates a new print stream.
      PrintStream​(OutputStream out, boolean autoFlush, Charset charset)
      Creates a new print stream, with the specified OutputStream, automatic line flushing and charset.
      PrintStream​(String fileName)
      Creates a new print stream, without automatic line flushing, with the specified file name.
      PrintStream​(String fileName, String csn)
      Creates a new print stream, without automatic line flushing, with the specified file name and charset.
      PrintStream​(String fileName, Charset charset)
      Creates a new print stream, without automatic line flushing, with the specified file name and charset.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      PrintStream append​(char c)
      Appends the specified character to this output stream.
      PrintStream append​(CharSequence csq)
      Appends the specified character sequence to this output stream.
      PrintStream append​(CharSequence csq, int start, int end)
      Appends a subsequence of the specified character sequence to this output stream.
      boolean checkError()
      Flushes the stream and checks its error state.
      protected void clearError()
      Clears the internal error state of this stream.
      void close()
      Closes the stream.
      void flush()
      Flushes the stream.
      PrintStream format​(String format, Object... args)
      Writes a formatted string to this output stream using the specified format string and arguments.
      PrintStream format​(Locale l, String format, Object... args)
      Writes a formatted string to this output stream using the specified format string and arguments.
      void print​(boolean b)
      Prints a boolean value.
      void print​(char c)
      Prints a character.
      void print​(char[] s)
      Prints an array of characters.
      void print​(double d)
      Prints a double-precision floating-point number.
      void print​(float f)
      Prints a floating-point number.
      void print​(int i)
      Prints an integer.
      void print​(long l)
      Prints a long integer.
      void print​(Object obj)
      Prints an object.
      void print​(String s)
      Prints a string.
      PrintStream printf​(String format, Object... args)
      A convenience method to write a formatted string to this output stream using the specified format string and arguments.
      PrintStream printf​(Locale l, String format, Object... args)
      A convenience method to write a formatted string to this output stream using the specified format string and arguments.
      void println()
      Terminates the current line by writing the line separator string.
      void println​(boolean x)
      Prints a boolean and then terminate the line.
      void println​(char x)
      Prints a character and then terminate the line.
      void println​(char[] x)
      Prints an array of characters and then terminate the line.
      void println​(double x)
      Prints a double and then terminate the line.
      void println​(float x)
      Prints a float and then terminate the line.
      void println​(int x)
      Prints an integer and then terminate the line.
      void println​(long x)
      Prints a long and then terminate the line.
      void println​(Object x)
      Prints an Object and then terminate the line.
      void println​(String x)
      Prints a String and then terminate the line.
      protected void setError()
      Sets the error state of the stream to true.
      void write​(byte[] buf, int off, int len)
      Writes len bytes from the specified byte array starting at offset off to this stream.
      void write​(int b)
      Writes the specified byte to this stream.