# clipb2var

クリップボードのテキストデータをコピーする。

    clipb2var <strvar> [<offset>]

## 解説

クリップボードのテキストデータを <strvar> へ代入する。
文字列変数の最大長の制限を受けるため、クリップボードのテキストデータが長すぎた場合は256バイト目以降が切り捨てられる。
<offset>を指定すると、offset*255+1文字目以降の内容が代入される。

このコマンドの実行結果はシステム変数 result に格納される。変数 result の値の意味は以下のとおり。

値 | 意味
--- | ---
0 | クリップボードを開けなかった。またはテキストデータではなかった。またはoffsetの値が適切ではなかった。
1 | <strvar> への代入に成功した。
2 | <strvar> への代入は行われたが、入りきらなかった部分は切り捨てられた。offsetの値を増やして再度clipb2varコマンドを実行する事で、切り捨てられた部分にアクセスできる。
3 | クリップボードの内容を記憶しておくためのメモリの確保に失敗した。この場合でも先頭から最大255バイトは変数に代入されるが、offsetを増やして再度clipb2varコマンドを実行しても切り捨てられた部分にはアクセスできない。

## 例

    clipb2var data
    messagebox data 'clipboard data'

    ; クリップボードの内容をファイル(clipboard.txt)に書き出す
    fileopen fp 'clipboard.txt' 0
    if result <> 0 end

    offset = 0
    do
        clipb2var buff offset
        if result > 0 filewrite fp buff
        offset = offset + 1
    loop while result = 2

    fileclose fp