REAL TO BLOB

4D v16.3

BLOB

REAL TO BLOB


REAL TO BLOB ( real ; BLOB ; realFormat {; offset \| *} )

引数	型	説明
real	実数	BLOBに書き込む実数値
BLOB	BLOB	実数値を受け取るBLOB
realFormat	倍長整数	0 Native real format 1 Extended real format 2 Macintosh Double real format 3 Windows Double real format
offset \| *	変数, 演算子	BLOB内のオフセット (バイト単位) または値を追加する場合 *
		*でない場合、書き込み後の新しいオフセット

説明

REAL TO BLOB コマンドは、blobに実数値realを書き込みます。

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

定数	型	値
Extended real format	倍長整数	1
Macintosh double real format	倍長整数	2
Native real format	倍長整数	0
PC double real format	倍長整数	3

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

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

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

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

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

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

例題 1

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

 C_REAL(vrValue)

 vrValue:=...

 REAL TO BLOB(vrValue;vxBlob;Native real format)

すべてのプラットフォームでvxBlobのサイズは8 bytesになります

例題 2

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

 C_REAL(vrValue)

 vrValue:=...

 REAL TO BLOB(vrValue;vxBlob;Extended real format)

すべてのプラットフォームでvxBlobのサイズは10bytesになります

例題 3

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

 C_REAL(vrValue)

 vrValue:=...

 REAL TO BLOB(vrValue;vxBlob;Macintosh double real format) ` または PC double real format

すべてのプラットフォームでvxBlobのサイズは8 bytesになります

例題 4

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

 SET BLOB SIZE(vxBlob;100)

 C_REAL(vrValue)

 vrValue:=...

 INTEGER TO BLOB(vrValue;vxBlob;Windows Double real format) ` または Macintosh double real format

すべてのプラットフォームでvxBlobのサイズは8 bytesになります

例題 5

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

 SET BLOB SIZE(vxBlob;100)

 REAL TO BLOB(vrValue;vxBlob;Extended real format;*)

すべてのプラットフォームでvxBlobのサイズは110bytesになります
すべてのプラットフォームで、実数値は#100から#109までのバイトに書き込まれます
BLOBの他のバイトは変更されません

例題 6

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

 SET BLOB SIZE(vxBlob;100)

 C_REAL(vrValue)

 vrValue:=...

 vlOffset:=50

 REAL TO BLOB(vrValue;vxBlob;Windows Double real format;vlOffset) ` または Macintosh double real format

すべてのプラットフォームでvxBlobのサイズは100bytesになります
すべてのプラットフォームで、実数値は#50から#57までのバイトに書き込まれます
BLOBの他のバイトは変更されません
変数vlOffsetは8インクリメントされ58となります

参照

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