文字ストリング

固定長文字ストリング (CHAR)

固定長ストリングの列の値は、すべて同じ長さです。 この長さは、その列の長さ属性によって決定されます。 長さ属性は、1 から 255 までの範囲でなければなりません。 ただし、ストリング単位が CODEUNITS32(1 から 63 までの範囲) の場合は除きます。

可変長文字ストリング

VARCHAR を引数として取る SYSFUN スキーマの関数は、 4,000 バイトよりも長い VARCHAR を引数として受け入れません。 しかし、そのような関数の多くには、 CLOB(1M) を受け入れるための代替シグニチャーが用意されています。 そのような代替シグニチャーが用意されている関数の場合は、 ユーザーが 4,000 バイトよりも長い VARCHAR ストリングを明示的に CLOB へキャストし、 結果が戻されたら任意の長さの VARCHAR へ再びキャストし直すという手順を取ります。

C の NULL 終了文字ストリングは、プリコンパイル・オプションの標準レベルに応じて、 異なった方式で処理されます。

文字ストリングのストリング単位指定

非 Unicode 文字ストリング・データ・タイプの場合、ストリング単位は常に OCTETS であり、変更することはできません。 Unicode 文字ストリング・データ・タイプの場合は、ストリング単位を文字ストリング・データ・タイプの長さ属性で明示的に指定することも、環境設定に基づいてデフォルトに設定することもできます。 文字ストリング・データ・タイプに FOR BIT DATA も指定されている場合は、 CODEUNITS32 を指定することはできず、CODEUNITS32 の環境設定は適用されません。

ストリング単位の環境設定は、NLS_STRING_UNITS グローバル変数の値、または string_units データベース構成パラメーターに基づきます。 データベース構成パラメーターを SYSTEM または CODEUNITS32 に設定することができます。 グローバル変数も SYSTEM または CODEUNITS32 に設定できますが、NULL に設定することもできます。 NULL 値は、SQL セッションで string_units データベース構成パラメーター設定を使用する必要があることを示します。 環境設定の値が SYSTEM である場合は、デフォルトのストリング単位設定として OCTETS が使用されます。

組み込み関数内のストリング単位

特定の組み込みストリング関数に対してストリング単位を指定する機能を使用して、「バイト・ベース方式」ではなく、「文字ベース方式」でストリング・データを処理することができます。 ストリング単位 によって、関数実行時の長さまたは位置に使用される単位が決まります。 一部のストリング関数のストリング単位として、CODEUNITS16、CODEUNITS32、または OCTETS を指定することができます。 ストリング単位が指定されていない場合は、通常、デフォルトのストリング単位はソース・ストリング引数のストリング単位で決まります (詳しくは、使用する関数の説明を参照してください)。 ストリング単位の引数は、Unicode データベースまたは非 Unicode データベースのパラメーターをサポートするストリング関数に対して指定できます。

CODEUNITS16

Unicode UTF-16 を操作の単位に指定します。 CODEUNITS16 が便利なのは、幅が 2 バイトのコード単位のデータをアプリケーションで処理する場合です。 補足文字 と呼ばれる一部の文字では、UTF-16 コード単位をエンコードする必要があることに注意してください。 例えば、音楽のト音記号の場合、2 つの UTF-16 コード単位 (UTF-16BE の X'D834' および X'DD1E') が必要です。

CODEUNITS32

Unicode UTF-32 を操作の単位に指定します。 CODEUNITS32 が便利なのは、単純な固定長の形式のデータを処理し、データの保管形式 (ASCII、UTF-8、または UTF-16) に関係なく同じ応答を戻す必要のあるアプリケーションの場合です。

注: ディスク上のストレージは、 UTF-8 エンコードを使用します。

OCTETS

バイトを操作の単位に指定します。 アプリケーションがバッファー・スペースを割り振ろうとしている場合や、単純なバイト処理を操作で使用する必要のある場合に、OCTETS が使用されることがよくあります。

OCTETS (バイト数) を使用して計算したストリングの算出長は、CODEUNITS16 または CODEUNITS32 を使用して計算したものとは異なることがあります。 OCTETS を使用した場合、ストリングの長さは、単純にストリング中のバイト数をカウントして判別されます。 CODEUNITS16 または CODEUNITS32 を使用した場合、ストリングの長さは、UTF-16 または UTF-32 でストリングを表すのに必要な 16 ビットまたは 32 ビットのコード単位の数をカウントして判別されます。 CODEUNITS16 と CODEUNITS32 を使用して決定される長さは、データに補足文字 ( CODEUNITS16 と CODEUNITS32 の違いを参照)が含まれていない限り、同一です。

   SELECT CHARACTER_LENGTH(NAME,CODEUNITS16) FROM T1
     WHERE NAME = 'Jürgen'

   SELECT CHARACTER_LENGTH(NAME,CODEUNITS32) FROM T1
     WHERE NAME = 'Jürgen'

   SELECT CHARACTER_LENGTH(NAME,OCTETS) FROM T1
     WHERE NAME = 'Jürgen'

Format    Representation of the name 'Jürgen'
--------  --------------------------------------
UTF-8	  X'4AC3BC7267656E'
UTF-16BE 	X'004A00FC007200670065006E'
UTF-32BE 	X'0000004A000000FC0000007200000067000000650000006E'

組み込み関数でストリング単位を指定しても、関数の結果のデータ・タイプ、ストリング単位、またはコード・ページには影響を与えません。 CODEUNITS16 または CODEUNITS32 を指定すると、必要に応じて、評価の目的でデータが Unicode に変換されます。

LOCATE 関数または POSITION 関数に対して OCTETS を指定した場合に、ストリング引数のコード・ページがそれぞれ異なっていると、データは source-string 引数のコード・ページに変換されます。 この場合、関数の結果は、source-string 引数のコード・ページのものになります。 単一のストリング引数をとる関数に対して OCTETS を指定した場合、データは、そのストリング引数のコード・ページで評価され、関数の結果は、そのストリング引数のコード・ページのものになります。

CODEUNITS16 と CODEUNITS32 の相違

CODEUNITS16 または CODEUNITS32 を指定すると、Unicode 補足文字がデータ中に入っていないかぎり、結果は同じになります。 その理由は、2 つの UTF-16 コード単位または 1 つの UTF-32 コード単位で補足文字が表されるからです。 UTF-8 では、非補足文字は 1 から 3 バイトまでで表され、補足文字は、4 バイトで表されます。 UTF-16 では、非補足文字は、1 つの CODEUNITS16 コード単位つまり 2 バイトで表され、補足文字は、2 つの CODEUNITS16 コード単位つまり 4 バイトで表されます。 UTF-32では、文字は 1 つの CODEUNITS32 コード単位または 4 バイトで表されます。

Query                                                Returns
-----                                                -------
SELECT CHARACTER_LENGTH(C1,CODEUNITS16) FROM T1      2

SELECT CHARACTER_LENGTH(C1,CODEUNITS32) FROM T1      1

SELECT CHARACTER_LENGTH(C1,OCTETS) FROM T1           4