QUOTE_LITERAL スカラー関数
QUOTE_LITERAL 関数は、SQL ステートメントでストリング定数として使用できるストリングを返します。
スキーマは SYSIBM です。
構文
- string-expression
-
入力ストリングを指定する式。この式は、文字ストリング、符号付き数値、または日時値を返す必要があります。入力ストリングのデータ・タイプが VARCHAR でない場合、関数が評価される前にデータ・タイプは VARCHAR に暗黙的にキャストされます。入力ストリングのデータ・タイプが CHAR または VARCHAR の場合、式を FOR BIT DATA にすることはできません (SQLSTATE 42815)。
結果
結果のデータ・タイプは VARCHAR であり、結果のコード・ページとストリング単位は入力ストリングと同じです。結果の長さ属性は、入力ストリングの長さ属性によって異なります。
| 入力ストリングの長さ属性 | 結果の長さ属性 |
|---|---|
L OCTETS |
min(32672,(L*2)+2) OCTETS |
L CODEUNITS32 |
min(8168,(L*2)+2) CODEUNITS32 |
引数が NULL になる可能性がある場合、結果も NULL になる可能性があります。引数が NULL の場合、結果は NULL 値になります。
例
| ステートメント | 結果 |
|---|---|
quote_literal(42.5) |
'42.5' |
quote_literal('You''re here!') |
'You''re here!' |