PrintStream JDK 1.6)

Constructors

private PrintStream (boolean autoFlush, OutputStream out)

public PrintStream (File file) throws FileNotFoundException

Creates a new print stream, without automatic line flushing, with the specified file.

public PrintStream (File file, String csn) throws FileNotFoundException UnsupportedEncodingException

Creates a new print stream, without automatic line flushing, with the specified file and charset.

public PrintStream (OutputStream out)

Creates a new print stream.

public PrintStream (OutputStream out, boolean autoFlush)

Creates a new print stream.

Creates a new print stream.
Parameters:
- out - The output stream to which values and objects will be printed
- autoFlush - A boolean; if true, the output buffer will be flushed whenever a byte array is written, one of the println methods is invoked, or a newline character or byte ('\n') is written
See Also: PrintWriter.PrintWriter(java.io.OutputStream, boolean),

public PrintStream (OutputStream out, boolean autoFlush, String encoding) throws UnsupportedEncodingException

Creates a new print stream.

Creates a new print stream.
Parameters:
- out - The output stream to which values and objects will be printed
- autoFlush - A boolean; if true, the output buffer will be flushed whenever a byte array is written, one of the println methods is invoked, or a newline character or byte ('\n') is written
- encoding - The name of a supported character encoding
Throws:
- UnsupportedEncodingException - If the named encoding is not supported
Since: 1.4

public PrintStream (String fileName) throws FileNotFoundException

Creates a new print stream, without automatic line flushing, with the specified file name.

public PrintStream (String fileName, String csn) throws FileNotFoundException UnsupportedEncodingException

Creates a new print stream, without automatic line flushing, with the specified file name and charset.

Methods

Hide/Show inherited methods

public PrintStream append (char c) [Specified in Appendable]

Appends the specified character to this output stream.

An invocation of this method of the form out.append(c) behaves in exactly the same way as the invocation

     out.print(c)

Returns: This output stream
Parameters:
- c - The 16-bit character to append
Since: 1.5

public PrintStream append (CharSequence csq) [Specified in Appendable]

Appends the specified character sequence to this output stream.

An invocation of this method of the form out.append(csq) behaves in exactly the same way as the invocation

     out.print(csq.toString())

Depending on the specification of toString for the character sequence csq, the entire sequence may not be appended. For instance, invoking then toString method of a character buffer will return a subsequence whose content depends upon the buffer's position and limit.
Returns: This output stream
Parameters:
- csq - The character sequence to append. If csq is null, then the four characters "null" are appended to this output stream.
Since: 1.5

public PrintStream append (CharSequence csq, int start, int end) [Specified in Appendable]

Appends a subsequence of the specified character sequence to this output stream.

An invocation of this method of the form out.append(csq, start, end) when csq is not null, behaves in exactly the same way as the invocation

     out.print(csq.subSequence(start, end).toString())

Returns: This output stream
Parameters:
- csq - The character sequence from which a subsequence will be appended. If csq is null, then characters will be appended as if csq contained the four characters "null".
- start - The index of the first character in the subsequence
- end - The index of the character following the last character in the subsequence
Throws:
- IndexOutOfBoundsException - If start or end are negative, start is greater than end, or end is greater than csq.length()
Since: 1.5

public boolean checkError ()

Flushes the stream and checks its error state.

Flushes the stream and checks its error state. The internal error state
is set to true when the underlying output stream throws an
IOException other than InterruptedIOException,
and when the setError method is invoked. If an operation
on the underlying output stream throws an
InterruptedIOException, then the PrintStream
converts the exception back into an interrupt by doing:


     Thread.currentThread().interrupt();

or the equivalent.
Returns: true if and only if this stream has encountered an IOException other than InterruptedIOException, or the setError method has been invoked

protected void clearError ()

Clears the internal error state of this stream.

public void close () [Overrides FilterOutputStream] [Specified in Closeable]

Closes the stream.

public void flush () [Overrides FilterOutputStream]

Flushes the stream.

public PrintStream format (Locale l, String format, Object args)

Writes a formatted string to this output stream using the specified format string and arguments.

public PrintStream format (String format, Object args)

Writes a formatted string to this output stream using the specified format string and arguments.

public void print (boolean b)

Prints a boolean value.

Prints a boolean value. The string produced by String.valueOf(boolean) is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
PrintStream.write(int) method.
Parameters:
- b - The boolean to be printed

public void print (char c)

Prints a character.

Prints a character. The character is translated into one or more bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
PrintStream.write(int) method.
Parameters:
- c - The char to be printed

public void print (char[] s)

Prints an array of characters.

Prints an array of characters. The characters are converted into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
PrintStream.write(int) method.
Parameters:
- s - The array of chars to be printed
Throws:
- NullPointerException - If s is null

public void print (double d)

Prints a double-precision floating-point number.

Prints a double-precision floating-point number. The string produced by
String.valueOf(double) is translated into
bytes according to the platform's default character encoding, and these
bytes are written in exactly the manner of the PrintStream.write(int) method.
Parameters:
- d - The double to be printed
See Also: Double.toString(double),

public void print (float f)

Prints a floating-point number.

Prints a floating-point number. The string produced by String.valueOf(float) is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
PrintStream.write(int) method.
Parameters:
- f - The float to be printed
See Also: Float.toString(float),

public void print (int i)

Prints an integer.

Prints an integer. The string produced by String.valueOf(int) is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
PrintStream.write(int) method.
Parameters:
- i - The int to be printed
See Also: Integer.toString(int),

public void print (long l)

Prints a long integer.

Prints a long integer. The string produced by String.valueOf(long) is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
PrintStream.write(int) method.
Parameters:
- l - The long to be printed
See Also: Long.toString(long),

public void print (Object obj)

Prints an object.

Prints an object. The string produced by the String.valueOf(Object) method is translated into bytes
according to the platform's default character encoding, and these bytes
are written in exactly the manner of the
PrintStream.write(int) method.
Parameters:
- obj - The Object to be printed
See Also: Object.toString(),

public void print (String s)

Prints a string.

Prints a string. If the argument is null then the string
"null" is printed. Otherwise, the string's characters are
converted into bytes according to the platform's default character
encoding, and these bytes are written in exactly the manner of the
PrintStream.write(int) method.
Parameters:
- s - The String to be printed

public 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.

An invocation of this method of the form out.printf(l, format, args) behaves in exactly the same way as the invocation

     out.format(l, format, args)

Returns: This output stream
Parameters:
- l - The {@linkplain java.util.Locale locale} to apply during formatting. If l is null then no localization is applied.
- format - A format string as described in Format string syntax
- args - Arguments referenced by the format specifiers in the format string. If there are more arguments than format specifiers, the extra arguments are ignored. The number of arguments is variable and may be zero. The maximum number of arguments is limited by the maximum dimension of a Java array as defined by the Java Virtual Machine Specification. The behaviour on a null argument depends on the conversion.
Throws:
- IllegalFormatException - If a format string contains an illegal syntax, a format specifier that is incompatible with the given arguments, insufficient arguments given the format string, or other illegal conditions. For specification of all possible formatting errors, see the Details section of the formatter class specification.
- NullPointerException - If the format is null
Since: 1.5

public 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.

An invocation of this method of the form out.printf(format, args) behaves in exactly the same way as the invocation

     out.format(format, args)

Returns: This output stream
Parameters:
- format - A format string as described in Format string syntax
- args - Arguments referenced by the format specifiers in the format string. If there are more arguments than format specifiers, the extra arguments are ignored. The number of arguments is variable and may be zero. The maximum number of arguments is limited by the maximum dimension of a Java array as defined by the Java Virtual Machine Specification. The behaviour on a null argument depends on the conversion.
Throws:
- IllegalFormatException - If a format string contains an illegal syntax, a format specifier that is incompatible with the given arguments, insufficient arguments given the format string, or other illegal conditions. For specification of all possible formatting errors, see the Details section of the formatter class specification.
- NullPointerException - If the format is null
Since: 1.5

public void println ()

Terminates the current line by writing the line separator string.

Terminates the current line by writing the line separator string. The
line separator string is defined by the system property
line.separator, and is not necessarily a single newline
character ('\n').

public void println (boolean x)

Prints a boolean and then terminate the line.

Prints a boolean and then terminate the line. This method behaves as
though it invokes PrintStream.print(boolean) and then
PrintStream.println().
Parameters:
- x - The boolean to be printed

public void println (char x)

Prints a character and then terminate the line.

Prints a character and then terminate the line. This method behaves as
though it invokes PrintStream.print(char) and then
PrintStream.println().
Parameters:
- x - The char to be printed.

public void println (char[] x)

Prints an array of characters and then terminate the line.

Prints an array of characters and then terminate the line. This method
behaves as though it invokes PrintStream.print(char[]) and
then PrintStream.println().
Parameters:
- x - an array of chars to print.

public void println (double x)

Prints a double and then terminate the line.

Prints a double and then terminate the line. This method behaves as
though it invokes PrintStream.print(double) and then
PrintStream.println().
Parameters:
- x - The double to be printed.

public void println (float x)

Prints a float and then terminate the line.

Prints a float and then terminate the line. This method behaves as
though it invokes PrintStream.print(float) and then
PrintStream.println().
Parameters:
- x - The float to be printed.

public void println (int x)

Prints an integer and then terminate the line.

Prints an integer and then terminate the line. This method behaves as
though it invokes PrintStream.print(int) and then
PrintStream.println().
Parameters:
- x - The int to be printed.

public void println (long x)

Prints a long and then terminate the line.

Prints a long and then terminate the line. This method behaves as
though it invokes PrintStream.print(long) and then
PrintStream.println().
Parameters:
- x - a The long to be printed.

public void println (Object x)

Prints an Object and then terminate the line.

Prints an Object and then terminate the line. This method calls
at first String.valueOf(x) to get the printed object's string value,
then behaves as
though it invokes PrintStream.print(String) and then
PrintStream.println().
Parameters:
- x - The Object to be printed.

public void println (String x)

Prints a String and then terminate the line.

Prints a String and then terminate the line. This method behaves as
though it invokes PrintStream.print(String) and then
PrintStream.println().
Parameters:
- x - The String to be printed.

protected void setError ()

Sets the error state of the stream to true.

This method will cause subsequent invocations of PrintStream.checkError() to return true until PrintStream.clearError() is invoked.
Since: JDK1.1

public void write (byte[] b) throws IOException [Inherited From FilterOutputStream]

Writes b.length bytes to this output stream.

The write method of FilterOutputStream calls its write method of three arguments with the arguments b, 0, and b.length.

Note that this method does not call the one-argument write method of its underlying stream with the single argument b.
Parameters:
- b - the data to be written.
Throws:
- IOException - if an I/O error occurs.
See Also: FilterOutputStream.write(byte[], int, int),

public void write (byte[] buf, int off, int len) [Overrides FilterOutputStream]

Writes len bytes from the specified byte array starting at offset off to this stream.

Writes len bytes from the specified byte array starting at offset off to this stream. If automatic flushing is enabled then the flush method will be invoked.

Note that the bytes will be written as given; to write characters that will be translated according to the platform's default character encoding, use the print(char) or println(char) methods.
Parameters:
- buf - A byte array
- off - Offset from which to start taking bytes
- len - Number of bytes to write

public void write (int b) [Overrides FilterOutputStream] [Specified in OutputStream]

Writes the specified byte to this stream.

Writes the specified byte to this stream. If the byte is a newline and automatic flushing is enabled then the flush method will be invoked.

Note that the byte is written as given; to write a character that will be translated according to the platform's default character encoding, use the print(char) or println(char) methods.
Parameters:
- b - The byte to be written
See Also: PrintStream.print(char), PrintStream.println(char),