BufSetAlpha

式エディタ > 関数ディレクトリ

 

バッファに文字データを格納

文字型またはRTFデータを BLOB バッファの指定した位置に挿入します。

構文：

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

パラメータ：

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

位置…データの挿入位置（Byte単位）を表す数値。バッファの先頭は1です。

値…挿入される文字データ

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

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

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

戻り値：

論理値… 処理に成功した場合「True」が返ります。

以下のような場合、処理は失敗します。

  • 参照項目が正しくない場合

  • 参照項目が BLOB でない場合

  • 位置パラメータが負数の場合

例：

BufSetAlpha('A'VAR,1,'filler',1,6,'FALSE'LOG)

 

1桁目から 6桁分 "filler" という文字列を挿入します。

注意事項：

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

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

BufSetAlpha('A'VAR,1,'ABCDE',2,5,'TRUE'LOG)

BufSetAlpha('A'VAR,7,'FGHIJ',2,5,'TRUE'LOG)

関連項目：

SetBufCnvParam