バイト・メッセージとは、本体がバイトのストリームからなるメッセージです。
xms::PropertyContext | +----xms::Message | +----xms::BytesMessage
メソッド | 説明 |
---|---|
getBodyLength | メッセージの本体が読み取り専用である場合に、メッセージの本体の長さを取得します。 |
readBoolean | バイト・メッセージ・ストリームからブール値を読み取ります。 |
readByte | バイト・メッセージ・ストリームから、次のバイトを符号付き 8 ビット整数として読み取ります。 |
readBytes | カーソルの現在位置から始まるバイトの配列を、バイト・メッセージ・ストリームから読み取ります。 |
readChar | バイト・メッセージ・ストリームから、次の 2 バイトを文字として読み取ります。 |
readDouble | バイト・メッセージ・ストリームから、次の 8 バイトを倍精度浮動小数点数として読み取ります。 |
readFloat | バイト・メッセージ・ストリームから、次の 4 バイトを浮動小数点数として読み取ります。 |
readInt | バイト・メッセージ・ストリームから、次の 4 バイトを符号付き 32 ビット整数として読み取ります。 |
readLong | バイト・メッセージ・ストリームから、次の 8 バイトを符号付き 64 ビット整数として読み取ります。 |
readShort | バイト・メッセージ・ストリームから、次の 2 バイトを符号付き 16 ビット整数として読み取ります。 |
readUnsignedByte | バイト・メッセージ・ストリームから、次のバイトを符号なし 8 ビット整数として読み取ります。 |
readUnsignedShort | バイト・メッセージ・ストリームから、次の 2 バイトを符号なし 16 ビット整数として読み取ります。 |
readUTF | バイト・メッセージ・ストリームから、UTF-8 でエンコードされたストリングを読み取ります。 |
reset | メッセージの本体を読み取り専用モードにして、カーソルをバイト・メッセージ・ストリームの先頭に位置変更します。 |
writeBoolean | バイト・メッセージ・ストリームへブール値を書き込みます。 |
writeByte | バイト・メッセージ・ストリームへ 1 バイト書き込みます。 |
writeBytes | バイト・メッセージ・ストリームへバイトの配列を書き込みます。 |
writeChar | 文字を、上位バイトを先にして、2 バイトでバイト・メッセージ・ストリームに書き込みます。 |
writeDouble | 倍精度浮動小数点数を長整数に変換し、その長整数を、上位バイトを先にして、8 バイトでバイト・メッセージ・ストリームに書き込みます。 |
writeFloat | 浮動小数点数を整数に変換し、その整数を、上位バイトを先にして、4 バイトでバイト・メッセージ・ストリームに書き込みます。 |
writeInt | 整数を、上位バイトを先にして、4 バイトでバイト・メッセージ・ストリームに書き込みます。 |
writeLong | 長整数を、上位バイトを先にして、8 バイトでバイト・メッセージ・ストリームに書き込みます。 |
writeShort | 短整数を、上位バイトを先にして、2 バイトでバイト・メッセージ・ストリームに書き込みます。 |
writeUTF | バイト・メッセージ・ストリームへ、UTF-8 でエンコードされたストリングを書き込みます。 |
xmsINT readBytes(xmsSBYTE *buffer, const xmsINT bufferLength, xmsINT *returnedLength) const;
カーソルの現在位置から始まるバイトの配列を、バイト・メッセージ・ストリームから読み取ります。
入力に NULL ポインターを指定すると、メソッドはそのバイトを読み取らずにスキップオーバーします。 呼び出しの前の、ストリームから読み取られる残りバイト数が、バッファーの長さより大きいか等しい場合、スキップされるバイト数は、バッファーの長さと等しくなります。残りバイト数の方が小さい場合、残りのすべてのバイトがスキップされます。
入力に NULL ポインターを指定すると、メソッドは値を戻しません。
String readUTF() const;
バイト・メッセージ・ストリームから、UTF-8 でエンコードされたストリングを読み取ります。必要な場合、XMS がストリング内の文字を UTF-8 からローカル・コード・ページに変換します。