関数 | 説明 |
---|---|
xmsBytesMsgGetBodyLength | メッセージの本体が読み取り専用である場合に、メッセージの本体の長さを取得します。 |
xmsBytesMsgReadBoolean | バイト・メッセージ・ストリームからブール値を読み取ります。 |
xmsBytesMsgReadByte | バイト・メッセージ・ストリームから、次のバイトを符号付き 8 ビット整数として読み取ります。 |
xmsBytesMsgReadBytes | カーソルの現在位置から始まるバイトの配列を、バイト・メッセージ・ストリームから読み取ります。 |
xmsBytesMsgReadBytesByRef | バイト・メッセージ・ストリームの先頭へのポインターを取得し、ストリームの長さを取得します。 |
xmsBytesMsgReadChar | バイト・メッセージ・ストリームから、次の 2 バイトを文字として読み取ります。 |
xmsBytesMsgReadDouble | バイト・メッセージ・ストリームから、次の 8 バイトを倍精度浮動小数点数として読み取ります。 |
xmsBytesMsgReadFloat | バイト・メッセージ・ストリームから、次の 4 バイトを浮動小数点数として読み取ります。 |
xmsBytesMsgReadInt | バイト・メッセージ・ストリームから、次の 4 バイトを符号付き 32 ビット整数として読み取ります。 |
xmsBytesMsgReadLong | バイト・メッセージ・ストリームから、次の 8 バイトを符号付き 64 ビット整数として読み取ります。 |
xmsBytesMsgReadShort | バイト・メッセージ・ストリームから、次の 2 バイトを符号付き 16 ビット整数として読み取ります。 |
xmsBytesMsgReadUnsignedByte | バイト・メッセージ・ストリームから、次のバイトを符号なし 8 ビット整数として読み取ります。 |
xmsBytesMsgReadUnsignedShort | バイト・メッセージ・ストリームから、次の 2 バイトを符号なし 16 ビット整数として読み取ります。 |
xmsBytesMsgReadUTF | バイト・メッセージ・ストリームから、UTF-8 でエンコードされたストリングを読み取ります。 |
xmsBytesMsgReset | メッセージの本体を読み取り専用モードにして、カーソルをバイト・メッセージ・ストリームの先頭に位置変更します。 |
xmsBytesMsgWriteBoolean | バイト・メッセージ・ストリームへブール値を書き込みます。 |
xmsBytesMsgWriteByte | バイト・メッセージ・ストリームへ 1 バイト書き込みます。 |
xmsBytesMsgWriteBytes | バイト・メッセージ・ストリームへバイトの配列を書き込みます。 |
xmsBytesMsgWriteChar | 文字を、上位バイトを先にして、2 バイトでバイト・メッセージ・ストリームに書き込みます。 |
xmsBytesMsgWriteDouble | 倍精度浮動小数点数を長整数に変換し、その長整数を、上位バイトを先にして、8 バイトでバイト・メッセージ・ストリームに書き込みます。 |
xmsBytesMsgWriteFloat | 浮動小数点数を整数に変換し、その整数を、上位バイトを先にして、4 バイトでバイト・メッセージ・ストリームに書き込みます。 |
xmsBytesMsgWriteInt | 整数を、上位バイトを先にして、4 バイトでバイト・メッセージ・ストリームに書き込みます。 |
xmsBytesMsgWriteLong | 長整数を、上位バイトを先にして、8 バイトでバイト・メッセージ・ストリームに書き込みます。 |
xmsBytesMsgWriteShort | 短整数を、上位バイトを先にして、2 バイトでバイト・メッセージ・ストリームに書き込みます。 |
xmsBytesMsgWriteUTF | バイト・メッセージ・ストリームへ、UTF-8 でエンコードされたストリングを書き込みます。 |
xmsRC xmsBytesMsgGetBodyLength(xmsHMsg message, xmsLONG *bodyLength, xmsHErrorBlock errorBlock);
メッセージの本体が読み取り専用である場合に、メッセージの本体の長さを取得します。
xmsRC xmsBytesMsgReadBoolean(xmsHMsg message, xmsBOOL *value, xmsHErrorBlock errorBlock);
xmsRC xmsBytesMsgReadByte(xmsHMsg message, xmsSBYTE *value, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、次のバイトを符号付き 8 ビット整数として読み取ります。
xmsRC xmsBytesMsgReadBytes(xmsHMsg message, xmsSBYTE *buffer, xmsINT bufferLength, xmsINT *returnedLength, xmsHErrorBlock errorBlock);
カーソルの現在位置から始まるバイトの配列を、バイト・メッセージ・ストリームから読み取ります。
入力に NULL ポインターを指定すると、関数はそのバイトを読み取らずにスキップオーバーします。呼び出しの前の、ストリームから読み取られる残りバイト数が、バッファーの長さより大きいか等しい場合、スキップされるバイト数は、バッファーの長さと等しくなります。残りバイト数の方が小さい場合、残りのすべてのバイトがスキップされます。
入力に NULL ポインターを指定すると、関数は値を戻しません。
xmsRC xmsBytesMsgReadBytesByRef(xmsHMsg message, xmsSBYTE **stream, xmsINT *length, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームの先頭へのポインターを取得し、ストリームの長さを取得します。
この関数の使用方法について詳しくは、参照によりストリングまたはバイト配列を戻す C 関数を参照してください。
xmsRC xmsBytesMsgReadChar(xmsHMsg message, xmsCHAR16 *value, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、次の 2 バイトを文字として読み取ります。
xmsRC xmsBytesMsgReadDouble(xmsHMsg message, xmsDOUBLE *value, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、次の 8 バイトを倍精度浮動小数点数として読み取ります。
xmsRC xmsBytesMsgReadFloat(xmsHMsg message, xmsFLOAT *value, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、次の 4 バイトを浮動小数点数として読み取ります。
xmsRC xmsBytesMsgReadInt(xmsHMsg message, xmsINT *value, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、次の 4 バイトを符号付き 32 ビット整数として読み取ります。
xmsRC xmsBytesMsgReadLong(xmsHMsg message, xmsLONG *value, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、次の 8 バイトを符号付き 64 ビット整数として読み取ります。
xmsRC xmsBytesMsgReadShort(xmsHMsg message, xmsSHORT *value, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、次の 2 バイトを符号付き 16 ビット整数として読み取ります。
xmsRC xmsBytesMsgReadUnsignedByte(xmsHMsg message, xmsBYTE *value, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、次のバイトを符号なし 8 ビット整数として読み取ります。
xmsRC xmsBytesMsgReadUnsignedShort(xmsHMsg message, xmsUSHORT *value, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、次の 2 バイトを符号なし 16 ビット整数として読み取ります。
xmsRC xmsBytesMsgReadUTF(xmsHMsg message, xmsCHAR *buffer, xmsINT bufferLength, xmsINT *actualLength, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームから、UTF-8 でエンコードされたストリングを読み取ります。必要な場合、XMS がストリング内の文字を UTF-8 からローカル・コード・ページに変換します。
この関数の使用方法について詳しくは、値によりストリングを戻す C 関数を参照してください。
XMSC_QUERY_SIZE を指定すると、ストリングは戻されませんが、actualLength パラメーターでストリング長が戻され、カーソルは拡張されません。
XMSC_SKIP を指定すると、関数はそのストリングを読み取らずにスキップします。
xmsRC xmsBytesMsgWriteBytes(xmsHMsg message, xmsSBYTE *value, xmsINT length, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームへバイトの配列を書き込みます。
xmsRC xmsBytesMsgWriteChar(xmsHMsg message, xmsCHAR16 value, xmsHErrorBlock errorBlock);
文字を、上位バイトを先にして、2 バイトでバイト・メッセージ・ストリームに書き込みます。
xmsRC xmsBytesMsgWriteDouble(xmsHMsg message, xmsDOUBLE value, xmsHErrorBlock errorBlock);
倍精度浮動小数点数を長整数に変換し、その長整数を、上位バイトを先にして、8 バイトでバイト・メッセージ・ストリームに書き込みます。
xmsRC xmsBytesMsgWriteFloat(xmsHMsg message, xmsFLOAT value, xmsHErrorBlock errorBlock);
浮動小数点数を整数に変換し、その整数を、上位バイトを先にして、4 バイトでバイト・メッセージ・ストリームに書き込みます。
xmsRC xmsBytesMsgWriteInt(xmsHMsg message, xmsINT value, xmsHErrorBlock errorBlock);
整数を、上位バイトを先にして、4 バイトでバイト・メッセージ・ストリームに書き込みます。
xmsRC xmsBytesMsgWriteLong(xmsHMsg message, xmsLONG value, xmsHErrorBlock errorBlock);
長整数を、上位バイトを先にして、8 バイトでバイト・メッセージ・ストリームに書き込みます。
xmsRC xmsBytesMsgWriteShort(xmsHMsg message, xmsSHORT value, xmsHErrorBlock errorBlock);
短整数を、上位バイトを先にして、2 バイトでバイト・メッセージ・ストリームに書き込みます。
xmsRC xmsBytesMsgWriteUTF(xmsHMsg message, xmsCHAR *value, xmsINT length, xmsHErrorBlock errorBlock);
バイト・メッセージ・ストリームへ、UTF-8 でエンコードされたストリングを書き込みます。必要な場合、XMS がストリング内の文字をローカル・コード・ページから UTF-8 に変換します。