OutputStreamWriter Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
An OutputStreamWriter is a bridge from character streams to byte streams:
Characters written to it are encoded into bytes using a specified java.nio.charset.Charset charset.
[Android.Runtime.Register("java/io/OutputStreamWriter", DoNotGenerateAcw=true)]
public class OutputStreamWriter : Java.IO.Writer[<Android.Runtime.Register("java/io/OutputStreamWriter", DoNotGenerateAcw=true)>]
type OutputStreamWriter = class
inherit Writer- Inheritance
- Derived
- Attributes
Remarks
An OutputStreamWriter is a bridge from character streams to byte streams: Characters written to it are encoded into bytes using a specified java.nio.charset.Charset charset. The charset that it uses may be specified by name or may be given explicitly, or the platform's default charset may be accepted.
Each invocation of a write() method causes the encoding converter to be invoked on the given character(s). The resulting bytes are accumulated in a buffer before being written to the underlying output stream. The size of this buffer may be specified, but by default it is large enough for most purposes. Note that the characters passed to the write() methods are not buffered.
For top efficiency, consider wrapping an OutputStreamWriter within a BufferedWriter so as to avoid frequent converter invocations. For example:
Writer out
= new BufferedWriter(new OutputStreamWriter(System.out));
A surrogate pair is a character represented by a sequence of two char values: A high surrogate in the range '\uD800' to '\uDBFF' followed by a low surrogate in the range '\uDC00' to '\uDFFF'.
A malformed surrogate element is a high surrogate that is not followed by a low surrogate or a low surrogate that is not preceded by a high surrogate.
This class always replaces malformed surrogate elements and unmappable character sequences with the charset's default substitution sequence. The java.nio.charset.CharsetEncoder class should be used when more control over the encoding process is required.
Added in JDK1.1.
Java documentation for java.io.OutputStreamWriter.
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
| OutputStreamWriter(IntPtr, JniHandleOwnership) |
A constructor used when creating managed representations of JNI objects; called by the runtime. |
| OutputStreamWriter(Stream, Charset) |
Creates an OutputStreamWriter that uses the given charset. |
| OutputStreamWriter(Stream, CharsetEncoder) |
Creates an OutputStreamWriter that uses the given charset encoder. |
| OutputStreamWriter(Stream, String) |
Creates an OutputStreamWriter that uses the named charset. |
| OutputStreamWriter(Stream) |
Creates an OutputStreamWriter that uses the default character encoding. |
Properties
| Class |
Returns the runtime class of this |
| Encoding |
Returns the name of the character encoding being used by this stream. |
| Handle |
The handle to the underlying Android instance. (Inherited from Object) |
| JniIdentityHashCode | (Inherited from Object) |
| JniPeerMembers | |
| Lock |
The object used to synchronize operations on this stream. (Inherited from Writer) |
| 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 writer. (Inherited from Writer) |
| Append(ICharSequence, Int32, Int32) |
Appends the specified character to this writer. (Inherited from Writer) |
| Append(ICharSequence) |
Appends the specified character to this writer. (Inherited from Writer) |
| Append(String, Int32, Int32) |
Appends the specified character to this writer. (Inherited from Writer) |
| Append(String) |
Appends the specified character to this writer. (Inherited from Writer) |
| AppendAsync(Char) | (Inherited from Writer) |
| AppendAsync(ICharSequence, Int32, Int32) | (Inherited from Writer) |
| AppendAsync(ICharSequence) | (Inherited from Writer) |
| Clone() |
Creates and returns a copy of this object. (Inherited from Object) |
| Close() |
Closes this writer. |
| 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 the stream. |
| 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) |
| 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, 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) |
| 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) |
| Write(Char[], Int32, Int32) |
Writes a portion of an array of characters. |
| Write(Char[]) |
Writes an array of characters. (Inherited from Writer) |
| Write(Int32) |
Writes a single character. (Inherited from Writer) |
| Write(String, Int32, Int32) |
Writes a portion of a string. (Inherited from Writer) |
| Write(String) |
Writes a string. (Inherited from Writer) |
| WriteAsync(Char[], Int32, Int32) | (Inherited from Writer) |
| WriteAsync(Char[]) | (Inherited from Writer) |
| WriteAsync(Int32) | (Inherited from Writer) |
| WriteAsync(String, Int32, Int32) | (Inherited from Writer) |
| WriteAsync(String) | (Inherited from Writer) |
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, Int32, Int32) | |
| Append(IAppendable, String) | |