Unpacking.UnpackCharStream Method (Stream)

UnpackingUnpackCharStream Method (Stream)

Unpacks raw value from the specified Stream as UnpackingStreamReader with UTF-8 encoding.

Namespace: MsgPack
Assembly: MsgPack (in MsgPack.dll) Version: 0.6.0

Syntax

public static UnpackingStreamReader UnpackCharStream(
	Stream source
)

Public Shared Function UnpackCharStream ( 
	source As Stream
) As UnpackingStreamReader

public:
static UnpackingStreamReader^ UnpackCharStream(
	Stream^ source
)

static member UnpackCharStream : 
        source : Stream -> UnpackingStreamReader

source: Type: System.IOStream
The Stream which contains Message Pack binary stream.

Type: UnpackingStreamReader
The UnpackingStreamReader which represents raw value stream as UTF-8 string.

Exceptions

Exception	Condition
ArgumentNullException	source is null.
ArgumentException	The CanRead of source is false.
UnpackException	source is not valid MessagePack stream. Note that the state of source will be unpredictable espicially it is not seekable.
MessageTypeException	The unpacked result in the source is not raw binary. Note that the state of source will be unpredictable espicially it is not seekable.

Remarks

if source contains invalid sequence as UTF-8 encoding string, the DecoderFallbackException may occurs on read char.

UnpackingStreamReader does not own source, so source still should be closed.

When the type of packed value is not known, use UnpackObject(Stream) instead.