BLOB スカラー関数

BLOB 関数は、いずれかのタイプのストリングまたは行 ID タイプの BLOB 表現を戻します。

スキーマは SYSIBM です。

文字列式

組み込み文字ストリング、グラフィック・ストリング、バイナリー・ストリング、または行 ID タイプの値を戻す式。

整数

結果のバイナリー・ストリングの長さ属性を指定する整数値。値は 1 と BLOB の最大長の間の整数でなければなりません。

string-expression が行 ID タイプである場合、integer を指定してはなりません。

integer を指定せず、string-expression が空ストリング定数の場合、結果の長さ属性は 1 であり、結果は空ストリングです。そうでなければ、結果の長さ属性は string-expression の長さ属性と同じです。ただし、入力がグラフィック・データの場合は除きます。この場合、結果の長さ属性は expression の長さの 2 倍になります。

関数の結果は BLOB です。

結果は NULL になる可能性があります。第 1 引数が NULL の場合、結果は NULL 値となります。

結果の実際の長さは、最小値が結果の長さ属性で、string-expression の実際の長さ (または入力がグラフィック・データの場合は string-expression の 2 倍の長さ) になります。 string-expression の長さが結果の長さ属性より長い場合は、切り捨てが行われます。最初の入力引数が文字ストリングで、すべての切り捨て文字がブランクであるか、または最初の入力引数がグラフィック・ストリングで、すべての切り捨て文字が 2 バイトのブランクである場合を除いて、警告が戻されます。

例 1: 以下の関数はストリング「This is a BLOB」の BLOB を戻します。

   SELECT BLOB('This is a BLOB')
     FROM SYSIBM.SYSDUMMY1;

例 2: 以下の関数は、ロケーター myclob_locator によって識別されるラージ・オブジェクトの BLOB を戻します。

   SELECT BLOB(:myclob_locator)
     FROM SYSIBM.SYSDUMMY1;

例 3: 表に TOPOGRAPHIC_MAP という名前の BLOB 列と MAP_NAME という名前の VARCHAR 列があるとします。ストリング「Engles Island」が入っているマップを探し、実際のマップの前にマップ名を連結して、単一のバイナリー・ストリングを戻します。

   SELECT BLOB(MAP_NAME || ':  ') || TOPOGRAPHIC_MAP
     FROM ONTARIO_SERIES_4
     WHERE TOPOGRAPHIC_MAP LIKE BLOB('%Engles Island%')