BufGetUnicode

 

バッファからUnicodeデータを取得

BLOBバッファ内の指定された位置の値をUnicodeデータに変換します。

Unicode型の場合は、定義した項目長の2倍の値をデータ長として長さや位置を指定する必要があります。

構文:

BufGetUnicode(参照項目、位置、記憶形式、長さ、ポインタ値)

パラメータ:

  • 参照項目 …… バッファとなる BLOB項目。VARリテラルが必要です。

  • 位置 …… 変換を開始する位置(Byte単位)を表す数値。バッファの先頭は1です。

  • 記憶形式 …… Magic xpaでの記憶形式を表す数値。

  • 長さ …… 記憶長を表す数値。(単位は、直前に実行したSetBufCnvParam関数によって設定されたエンコード指定に依存します。)

  • ポインタ値 …… Unicodeデータ値が、直接バッファ書き込まれるか、ポインタとして書かれるべきであるかどうかを示す論理値。「True」  の場合は、ポインタとして文字値を書き込みます。

戻り値:

変換が成功した時はUnicode型の文字列が返ります。失敗した場合は空白が返ります。

以下の場合は失敗します。

  • 位置パラメータに負数が指定された場合

  • 位置や長さパラメータが、 バッファの内容の範囲外を指定している場合

  • 記憶形式パラメータが正しくない場合

  • 長さパラメータが正しくない場合

関連トピック:

BufSetUnicode, SetBufCnvParam

バッファ