4D v14.3

BLOB to list

ホーム

 
4D v14.3
BLOB to list

BLOB to list 


 

BLOB to list ( BLOB {; offset} ) -> 戻り値 
引数   説明
BLOB  BLOB in 階層リストが格納されたBLOB
offset  倍長整数 in BLOB内のオフセット (バイト単位)
in 読み込み後の新しいオフセット
戻り値  ListRef in 新しく作成されたリスト参照

説明   

BLOB to list コマンドはblob中、offsetで指定されたバイトオフセット(ゼロから開始)に格納されているデータを使用して新しい階層リストを作成し、このリストのリスト参照番号を返します。

BLOBデータはコマンドと整合性を保っていなければなりません。通常、LIST TO BLOBコマンドを使用して階層リストを格納したBLOBを使用します。

オプション引数offsetを指定しない場合には、階層リストはBLOBの最初から読み込まれます。複数の変数やリストが格納されているBLOBを操作する場合には、offsetにオフセットを格納した数値型変数を渡さなければなりません。呼び出しの前に、この数値型変数を適切なオフセットに設定します。呼び出しの後で、この数値型変数はBLOB内に格納されている次の変数へのオフセットを返します。

呼び出し後、階層リストが正常に作成された場合には、システム変数OKは1に設定されます。階層リストを作成するために必要なメモリがない等の理由で処理が実行できなかった場合には、システム変数OKは0に設定されます。

プラットフォーム独立性に関する注意

BLOB to listLIST TO BLOBは、 BLOBに格納されたリストを処理するために4Dの内部フォーマットを使用します。この利点として、これら二つのコマンドを使用する際、プラットフォーム 間のバイトスワップを気にする必要はありません。言い換えればこれらのコマンドを使用してWindowsで作成されたBLOBをMacintoshで使用 する、あるいはその逆を行うことができます。

例題  

この例では、データ入力フォームが画面に表示される前に、このフォームのフォームメソッドがBLOBフィールドからリストを抽出し、データ入力が検証されるとこのリストをBLOBフィールドに再び格納します:

  ` [Things To Do];"Input" フォームメソッド
 
 Case of
 
    :(Form event=On Load)
       hList:=BLOB to list([Things To Do]Other Crazy Ideas)
       If(OK=0)
          hList:=New list
       End if
 
    :(Form event=On Unload)
       CLEAR LIST(hList;*)
 
    :(bValidate=1)
       LIST TO BLOB(hList;[Things To Do]Other Crazy Ideas)
 
 End case

リストが正しく作成されると、OK変数には1が設定されます。そうでなければ0が設定されます。

 
プロパティ 

プロダクト: 4D
テーマ: BLOB
番号: 557

このコマンドはOKシステム変数を更新します

 
履歴 

初出: 4D v6

 
参照 

LIST TO BLOB

 
タグ 

List, Hierarchical List

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v11 SQL Release 6)
ランゲージリファレンス ( 4D v12.4)
ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v13.5)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)