BufGetAlpha

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

BLOBバッファの指定された位置の文字データを取得します。

構文：

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

パラメータ：

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

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

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

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

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

戻り値：

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

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

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

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

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

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

注意事項：

記憶形式タイプとして「LString」または「ZString」を使用する場合、取得する文字長と位置の関係に注意してください。文字の末尾のNULLを考慮する必要があります。

例えば、半角５桁（5バイト）の文字が格納されている次の領域の位置は、６バイト分が加算され「7」になります。

BufGetAlpha('A'VAR,1,2,5,'TRUE'LOG） …… 'ABCDE'

BufGetAlpha（'A'VAR,7,2,5,'TRUE'LOG） …… 'FGHIJ'

関連トピック：

SetBufCnvParam

バッファ