ストリーム・メッセージとは、本体が値のストリームで構成されるメッセージです。それぞれの値に、関連付けられたデータ型があります。本体の内容は、順番に読み書きされます。
IBM.XMS.IPropertyContext | +----IBM.XMS.IMessage | +----IBM.XMS.IStreamMessage
アプリケーションがメッセージ・ストリームから値を読み取るとき、値は XMS によって別のデータ型に変換される可能性があります。この形式の暗黙の型変換について詳しくは、ストリーム・メッセージを参照してください。
メソッド | 説明 |
---|---|
ReadBoolean | メッセージ・ストリームからブール値を読み取ります。 |
ReadByte | メッセージ・ストリームから符号付き 8 ビット整数を読み取ります。 |
ReadBytes | メッセージ・ストリームからバイトの配列を読み取ります。 |
ReadChar | メッセージ・ストリームから 2 バイト文字を読み取ります。 |
ReadDouble | メッセージ・ストリームから 8 バイトの倍精度浮動小数点数を読み取ります。 |
ReadFloat | メッセージ・ストリームから 4 バイトの浮動小数点数を読み取ります。 |
ReadInt | メッセージ・ストリームから符号付き 32 ビット整数を読み取ります。 |
ReadLong | メッセージ・ストリームから符号付き 64 ビット整数を読み取ります。 |
ReadObject | メッセージ・ストリームから値を読み取り、そのデータ型を戻します。 |
ReadShort | メッセージ・ストリームから符号付き 16 ビット整数を読み取ります。 |
ReadString | メッセージ・ストリームからストリングを読み取ります。 |
Reset | メッセージの本体を読み取り専用モードにして、カーソルをメッセージ・ストリームの先頭に位置変更します。 |
WriteBoolean | メッセージ・ストリームへブール値を書き込みます。 |
WriteByte | メッセージ・ストリームへバイトを書き込みます。 |
WriteBytes | メッセージ・ストリームへバイトの配列を書き込みます。 |
WriteChar | 文字を、上位バイトを先にして、2 バイトでメッセージ・ストリームに書き込みます。 |
WriteDouble | 倍精度浮動小数点数を長整数に変換し、その長整数を、上位バイトを先にして、8 バイトでメッセージ・ストリームに書き込みます。 |
WriteFloat | 浮動小数点数を整数に変換し、その整数を、上位バイトを先にして、4 バイトでメッセージ・ストリームに書き込みます。 |
WriteInt | 整数を、上位バイトを先にして、4 バイトでメッセージ・ストリームに書き込みます。 |
WriteLong | 長整数を、上位バイトを先にして、8 バイトでメッセージ・ストリームに書き込みます。 |
WriteObject | メッセージ・ストリームに、指定されたデータ型の値を書き込みます。 |
WriteShort | 短整数を、上位バイトを先にして、2 バイトでメッセージ・ストリームに書き込みます。 |
WriteString | メッセージ・ストリームへストリングを書き込みます。 |
Int32 ReadBytes(Byte[] array);
配列のバイト数が、バッファーの長さ以下である場合は、配列全体がバッファーに読み取られます。配列のバイト数がバッファーの長さを超える場合、配列の一部でバッファーはいっぱいになり、内部カーソルは次に読み取られるバイトの位置をマークします。次に readBytes() を呼び出すと、カーソルの現在位置から始まる配列から、バイトが読み取られます。
入力に NULL ポインターを指定すると、呼び出しではそのバイトの配列は読み取られずにスキップオーバーされます。
入力に NULL ポインターを指定すると、メソッドは値を戻しません。