BLOB
Blobクラスを使って、BLOB オブジェクト (4D.Blob) を操作することができます。
概要
| 4D.Blob.new() : 4D.Blob 4D.Blob.new( blobScal : Blob ) : 4D.Blob 4D.Blob.new( blobObj : 4D.Blob ) : 4D.Blob 新規の 4D.Blob オブジェクトを作成し、(任意で) 別の BLOBデータ (スカラーBLOB または 4D.Blob) のコピーを格納します |
.size : Real 4D.Blob のサイズを返します (バイト単位)。 |
| .slice() : 4D.Blob .slice( start : Real ) : 4D.Blob .slice( start : Real; end : Real ) : 4D.Blob 呼び出し対象である BLOB のデータの一部を参照する新規の 4D.Blob を作成して返します。 元の BLOB は変更されません。 |
4D.Blob.new()
履歴
| リリース | 内容 |
|---|---|
| 19 R2 | 追加 |
4D.Blob.new() : 4D.Blob
4D.Blob.new( blobScal : Blob ) : 4D.Blob
4D.Blob.new( blobObj : 4D.Blob ) : 4D.Blob
| 引数 | 型 | 説明 | |
|---|---|---|---|
| blob | BLOB または 4D.Blob | -> | コピーする BLOB |
| 戻り値 | 4D.Blob | <- | 新規 4D.Blob |
|
説明
4D.Blob.new は、 新規の 4D.Blob オブジェクトを作成し、(任意で) 別の BLOBデータ (スカラーBLOB または 4D.Blob) のコピーを格納します.
blob 引数が渡されなかった場合、関数は空の 4D.Blob を返します。
.size
.size : Real
説明
.size プロパティは、 4D.Blob のサイズを返します (バイト単位)。
.slice()
履歴
| リリース | 内容 |
|---|---|
| 19 R2 | 追加 |
.slice() : 4D.Blob
.slice( start : Real ) : 4D.Blob
.slice( start : Real; end : Real ) : 4D.Blob
| 引数 | 型 | 説明 | |
|---|---|---|---|
| start | Real | -> | 新しい 4D.Blob に含める最初のバイトのインデックス |
| end | Real | -> | 新しい 4D.Blob に含めない最初のバイトのインデックス |
| 戻り値 | 4D.Blob | <- | 新規 4D.Blob |
|
説明
.slice() 関数は、 呼び出し対象である BLOB のデータの一部を参照する新規の 4D.Blob を作成して返します。 元の BLOB は変更されません。
start 引数は、新しい 4D.Blob に含める最初のバイトを示す BLOB のインデックスです。 負の値を指定した場合、4D は BLOB の末尾から先頭に向かってオフセットしたものとして扱います。 たとえば、-10 は BLOB の最後から 10番目のバイトを表します。 デフォルト値は 0 です。 start にソースBLOB のサイズより大きな値を指定すると、返される 4D.Blob のサイズは 0 になり、データは含まれません。
end 引数は、新しい 4D.Blob に含めない最初のバイトを示す BLOB のインデックスです。つまる、指定インデックスのバイトは新しい 4D.Blob から除外されます。 負の値を指定した場合、4D は BLOB の末尾から先頭に向かってオフセットしたものとして扱い ます。 たとえば、-10 は BLOB の最後から 10番目のバイトを表します。 デフォルト値は BLOB のサイズです。
例題
var $myBlob : 4D.Blob
// 4D.Blob にテキストを格納します
CONVERT FROM TEXT("Hello, World!"; "UTF-8"; $myBlob)
$is4DBlob:=OB Instance of($myBlob; 4D.Blob); // True
$myString:=Convert to text($myBlob; "UTF-8")
// $myString は "Hello, World!" を格納しています
// $myBlob から新しい 4D.Blob を作成します
$myNewBlob:=$myBlob.slice(0; 5)
$myString:=Convert to text($myNewBlob; "UTF-8")
// $myString は "Hello" を格納します