PrintStream. It does not contain methods for writing raw bytes, for which
a program should use unencoded byte streams.
Unlike the class, if automatic flushing is enabled
it will be done only when one of the println, printf, or
format methods is invoked, rather than whenever a newline character
happens to be output. These methods use the platform's own notion of line
separator rather than the newline character.
PrintStream
Methods in this class never throw I/O exceptions, although some of its
constructors may. The client may inquire as to whether any errors have
occurred by invoking checkError().
java.lang.NullPointerException is csn is nullUnsupportedEncodingException if the charset is not supportedout An output streamOutputStreamWriter.(java.io.OutputStream) out An output streamautoFlush A boolean; if true, the println,
printf, or format methods will
flush the output bufferOutputStreamWriter.(java.io.OutputStream) OutputStreamWriter,
which will encode characters using the java.nio.charset.Charset.defaultCharset() for this
instance of the Java virtual machine.
fileName
The name of the file to use as the destination of this writer.
If the file exists then it will be truncated to zero size;
otherwise, a new file will be created. The output will be
written to the file and is buffered.FileNotFoundException
If the given string does not denote an existing, writable
regular file and a new regular file of that name cannot be
created, or if some other error occurs while opening or
creating the filejava.lang.SecurityException
If a security manager is present and java.lang.SecurityManager.checkWrite(java.io.FileDescriptor) denies write
access to the file OutputStreamWriter, which will encode characters using the provided
charset.
fileName
The name of the file to use as the destination of this writer.
If the file exists then it will be truncated to zero size;
otherwise, a new file will be created. The output will be
written to the file and is buffered.csn
The name of a supported charsetFileNotFoundException
If the given string does not denote an existing, writable
regular file and a new regular file of that name cannot be
created, or if some other error occurs while opening or
creating the filejava.lang.SecurityException
If a security manager is present and java.lang.SecurityManager.checkWrite(java.io.FileDescriptor) denies write
access to the fileUnsupportedEncodingException
If the named charset is not supportedOutputStreamWriter,
which will encode characters using the java.nio.charset.Charset.defaultCharset() for this
instance of the Java virtual machine.
file
The file to use as the destination of this writer. If the file
exists then it will be truncated to zero size; otherwise, a new
file will be created. The output will be written to the file
and is buffered.FileNotFoundException
If the given file object does not denote an existing, writable
regular file and a new regular file of that name cannot be
created, or if some other error occurs while opening or
creating the filejava.lang.SecurityException
If a security manager is present and java.lang.SecurityManager.checkWrite(java.io.FileDescriptor)
denies write access to the file OutputStreamWriter, which will encode characters using the provided
charset.
file
The file to use as the destination of this writer. If the file
exists then it will be truncated to zero size; otherwise, a new
file will be created. The output will be written to the file
and is buffered.csn
The name of a supported charsetFileNotFoundException
If the given file object does not denote an existing, writable
regular file and a new regular file of that name cannot be
created, or if some other error occurs while opening or
creating the filejava.lang.SecurityException
If a security manager is present and java.lang.SecurityManager.checkWrite(java.io.FileDescriptor)
denies write access to the fileUnsupportedEncodingException
If the named charset is not supportedcheckError() This method will cause subsequent invocations of to return true until checkError() is invoked.
clearError()
This method will cause subsequent invocations of to return false until another write
operation fails and invokes checkError().
setError()
java.lang.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 write(int) method.
b The boolean to be printedwrite(int) method.
c The char to be printedjava.lang.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 write(int)
method.
i The int to be printedjava.lang.Integer.toString(int)java.lang.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 write(int)
method.
l The long to be printedjava.lang.Long.toString(long)java.lang.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 write(int)
method.
f The float to be printedjava.lang.Float.toString(float)java.lang.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 write(int) method.
d The double to be printedjava.lang.Double.toString(double)write(int)
method.
s The array of chars to be printedjava.lang.NullPointerException If s is nullnull 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
write(int) method.
s The String to be printedjava.lang.String.valueOf(java.lang.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 write(int)
method.
obj The Object to be printedjava.lang.Object.toString()print(boolean) and then
println().
x the boolean value to be printedprint(char) and then println().
x the char value to be printedprint(int) and then println().
x the int value to be printedprint(long) and then
println().
x the long value to be printedprint(float) and then
println().
x the float value to be printedprint(double) and then println().
x the double value to be printedprint(char[]) and then
println().
x the array of char values to be printedprint(java.lang.String) and then
println().
x the String value to be printedprint(java.lang.String) and then
println().
x The Object to be printed.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)
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.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.java.lang.NullPointerException
If the format is nullAn 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)
l
The 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.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.java.lang.NullPointerException
If the format is null The locale always used is the one returned by , regardless of any
previous invocations of other formatting methods on this object.
java.util.Locale.getDefault()
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.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.java.lang.NullPointerException
If the format is nulll
The 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.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.java.lang.NullPointerException
If the format is nullAn invocation of this method of the form out.append(csq) behaves in exactly the same way as the invocation
out.write(csq.toString())
Depending on the specification of toString for the character sequence csq, the entire sequence may not be appended. For instance, invoking the toString method of a character buffer will return a subsequence whose content depends upon the buffer's position and limit.
csq
The character sequence to append. If csq is
null, then the four characters "null" are
appended to this writer.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.write(csq.subSequence(start, end).toString())
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 subsequenceend
The index of the character following the last character in the
subsequencejava.lang.IndexOutOfBoundsException
If start or end are negative, start
is greater than end, or end is greater than
csq.length()