PrintStream Class

Definition

A PrintStream adds functionality to another output stream, namely the ability to print representations of various data values conveniently.

[Android.Runtime.Register("java/io/PrintStream", DoNotGenerateAcw=true)]
public class PrintStream : Java.IO.FilterOutputStream, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IAppendable
[<Android.Runtime.Register("java/io/PrintStream", DoNotGenerateAcw=true)>]
type PrintStream = class
    inherit FilterOutputStream
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IAppendable
Inheritance
Attributes
Implements

Remarks

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 of the underlying output stream 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 the 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 java.nio.charset.CharsetEncoder class should be used when more control over the encoding process is required.

Added in 1.0.

Java documentation for java.io.PrintStream.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Constructors

PrintStream(File)

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

PrintStream(File, Charset)

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

PrintStream(File, String)

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

PrintStream(IntPtr, JniHandleOwnership)

A constructor used when creating managed representations of JNI objects; called by the runtime.

PrintStream(Stream)

Creates a new print stream.

PrintStream(Stream, Boolean)

Creates a new print stream.

PrintStream(Stream, Boolean, Charset)

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

PrintStream(Stream, Boolean, String)

Creates a new print stream.

PrintStream(String)

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

PrintStream(String, Charset)

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

PrintStream(String, String)

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

Properties

Class

Returns the runtime class of this Object.

(Inherited from Object)
Handle

The handle to the underlying Android instance.

(Inherited from Object)
JniIdentityHashCode (Inherited from Object)
JniPeerMembers
Out

The underlying output stream to be filtered.

(Inherited from FilterOutputStream)
PeerReference (Inherited from Object)
ThresholdClass

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

ThresholdType

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

Methods

Append(Char)

Appends the specified character to this output stream.

Append(ICharSequence)

Appends the specified character to this output stream.

Append(ICharSequence, Int32, Int32)

Appends the specified character to this output stream.

Append(String)

Appends the specified character to this output stream.

Append(String, Int32, Int32)

Appends the specified character to this output stream.

AppendAsync(Char)
AppendAsync(ICharSequence)
AppendAsync(ICharSequence, Int32, Int32)
CheckError()

Flushes the stream and checks its error state.

ClearError()

Clears the internal error state of this stream.

Clone()

Creates and returns a copy of this object.

(Inherited from Object)
Close()

Closes this output stream and releases any system resources associated with this stream.

(Inherited from OutputStream)
Dispose() (Inherited from Object)
Dispose(Boolean) (Inherited from Object)
Equals(Object)

Indicates whether some other object is "equal to" this one.

(Inherited from Object)
Flush()

Flushes this output stream and forces any buffered output bytes to be written out.

(Inherited from OutputStream)
Format(Locale, String, Object[])

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

Format(String, Object[])

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

FormatAsync(Locale, String, Object[])
FormatAsync(String, Object[])
GetHashCode()

Returns a hash code value for the object.

(Inherited from Object)
JavaFinalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

(Inherited from Object)
Notify()

Wakes up a single thread that is waiting on this object's monitor.

(Inherited from Object)
NotifyAll()

Wakes up all threads that are waiting on this object's monitor.

(Inherited from Object)
Print(Boolean)

Prints a boolean value.

Print(Char)

Prints a character.

Print(Char[])

Prints an array of characters.

Print(Double)

Prints a double-precision floating-point number.

Print(Int32)

Prints an integer.

Print(Int64)

Prints a long integer.

Print(Object)

Prints an object.

Print(Single)

Prints a floating-point number.

Print(String)

Prints a string.

PrintAsync(Boolean)
PrintAsync(Char)
PrintAsync(Char[])
PrintAsync(Double)
PrintAsync(Int32)
PrintAsync(Int64)
PrintAsync(Object)
PrintAsync(Single)
PrintAsync(String)
Printf(Locale, String, Object[])

A convenience method to write a formatted string to this output stream using the specified format string and arguments.

Printf(String, Object[])

A convenience method to write a formatted string to this output stream using the specified format string and arguments.

PrintfAsync(Locale, String, Object[])
PrintfAsync(String, Object[])
Println()

Terminates the current line by writing the line separator string.

Println(Boolean)

Prints a boolean and then terminate the line.

Println(Char)

Prints a character and then terminate the line.

Println(Char[])

Prints an array of characters and then terminate the line.

Println(Double)

Prints a double and then terminate the line.

Println(Int32)

Prints an integer and then terminate the line.

Println(Int64)

Prints a long and then terminate the line.

Println(Object)

Prints an Object and then terminate the line.

Println(Single)

Prints a float and then terminate the line.

Println(String)

Prints a String and then terminate the line.

PrintlnAsync()
PrintlnAsync(Boolean)
PrintlnAsync(Char)
PrintlnAsync(Char[])
PrintlnAsync(Double)
PrintlnAsync(Int32)
PrintlnAsync(Int64)
PrintlnAsync(Object)
PrintlnAsync(Single)
PrintlnAsync(String)
SetError()

Sets the error state of the stream to true.

SetHandle(IntPtr, JniHandleOwnership)

Sets the Handle property.

(Inherited from Object)
ToArray<T>() (Inherited from Object)
ToString()

Returns a string representation of the object.

(Inherited from Object)
UnregisterFromRuntime() (Inherited from Object)
Wait()

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>.

(Inherited from Object)
Wait(Int64)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)
Wait(Int64, Int32)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)
Write(Byte[])

Writes b.length bytes from the specified byte array to this output stream.

(Inherited from OutputStream)
Write(Byte[], Int32, Int32)

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

(Inherited from OutputStream)
Write(Int32)

Writes the specified byte to this output stream.

(Inherited from FilterOutputStream)
WriteAsync(Byte[]) (Inherited from OutputStream)
WriteAsync(Byte[], Int32, Int32) (Inherited from OutputStream)
WriteAsync(Int32) (Inherited from OutputStream)
WriteBytes(Byte[])

Explicit Interface Implementations

IJavaPeerable.Disposed() (Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced() (Inherited from Object)
IJavaPeerable.Finalized() (Inherited from Object)
IJavaPeerable.JniManagedPeerState (Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32) (Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) (Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference) (Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)

Performs an Android runtime-checked type conversion.

JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)
FlushAsync(IFlushable)
Append(IAppendable, String)
Append(IAppendable, String, Int32, Int32)

Applies to