4D v14.3

INTEGER TO BLOB

ホーム

 
4D v14.3
INTEGER TO BLOB

INTEGER TO BLOB 


 

INTEGER TO BLOB ( entier ; BLOB ; ordreOctet {; offset | *} )  
引数   説明
entier  倍長整数 in BLOBに書き込む整数値
BLOB  BLOB in 整数値を受け取るBLOB
ordreOctet  倍長整数 in 0 Native byte ordering 1 Macintosh byte ordering 2 PC byte ordering
offset | *  変数, 演算子 in BLOB内のオフセット (バイト単位) または値を追加する場合 *
in *でない場合、書き込み後の新しいオフセット

説明   

INTEGER TO BLOB コマンドは、blobに2バイトのinteger値を書き込みます。

byteOrder引数は、2バイト整数値が書き込まれる際のバイトオーダーを決定します。4Dが提供する以下の定義済み定数のうち、いずれか1つを渡します:

定数
Macintosh byte ordering 倍長整数 1
Native byte ordering 倍長整数 0
PC byte ordering 倍長整数 2

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

MacintoshとPCプラットフォーム間でBLOBを交換する場合、このコマンドを使用する際のバイトスワップの管理は開発者に任されています。

オプションの * 引数を渡すと、2バイト整数値はBLOBの最後に追加され、BLOBサイズはそれに従い拡張されます。オプションの * 引数を使用することで、BLOBがメモリに収まる限り、整数, 倍長整数, 実数 あるいは テキスト値 (他のBLOBコマンド参照) をBLOBに連続して格納できます。

オプション引数 * やoffset変数引数を指定しない場合、2バイトの整数値はBLOBの最初に格納され、それ以前の内容を上書きします。これに合わせてBLOBのサイズも調整されます。

offset変数引数を渡した場合、2バイト整数値はBLOB内のオフセット(ゼ ロから開始)に書き込まれます。2バイトの整数の値を書き込む位置に関わらず、BLOBのサイズは渡した位置に従って(必要に応じてさらに最大2バイトま で)増加します。現在書き込んでいるバイト以外の新しく割り当てられるバイトは、ゼロに初期化されます。

呼び出し後、offset変数引数は、書き込まれたバイト数分だけインクリメントされます。したがって、同じoffset変数引数を別のBLOB書き込みコマンドにも使用し、別の値をBLOBに追加できます。

以下のコードを実行すると:

 INTEGER TO BLOB(0x0206;vxBlob;Native byte ordering)
  • vxBlobのサイズは2バイトになります。
  • Power PCプラットフォーム: vxBlob{0} = $02vxBLOB{1} = $06
  • Intelプラットフォーム: vxBLOB{0} = $06vxBLOB{1} = $02

以下のコードを実行すると:

 INTEGER TO BLOB(0x0206;vxBlob;Macintosh byte ordering)
  • vxBlobのサイズは2バイトになります。
  • すべてのプラットフォーム: vxBLOB{0} = $02vxBLOB{1} = $06

以下のコードを実行すると:

 INTEGER TO BLOB(0x0206;vxBlob;PC byte ordering)
  • vxBlobのサイズは2バイトになります。
  • すべてのプラットフォーム: vxBLOB{0} = $06vxBLOB{1} = $02

以下のコードを実行すると:

 SET BLOB SIZE(vxBlob;100)
 INTEGER TO BLOB(0x0206;vxBlob;PC byte ordering;*)
  • vxBlobのサイズは102バイトになります。
  • すべてのプラットフォーム: vxBLOB{100} = $06vxBLOB{101} = $02
  • BLOBの他のバイトは変更されない

以下のコードを実行すると:

 SET BLOB SIZE(vxBlob;100)
 vlOffset:=50
 INTEGER TO BLOB(0x0206;vxBlob;Macintosh byte ordering;vlOffset)
  • vxBlobのサイズは100バイトになります。
  • すべてのプラットフォーム: vxBLOB{50} = $02vxBLOB{51} = $06
  • BLOBの他のバイトは変更されない
  • 変数vlOffsetは2インクリメントされ52となる

 
プロパティ 

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

 
履歴 

初出: 4D v6

 
参照 

BLOB to integer
BLOB to longint
BLOB to real
BLOB to text
LONGINT TO BLOB
REAL TO BLOB
TEXT TO BLOB

 
タグ 

Integer

 
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)