OCTET_LENGTH

OCTET_LENGTH 関数は、ストリング式の長さをオクテット数 (バイト数) で戻します。

構文図を読む構文図をスキップする
>>---OCTET_LENGTH----(--expression--)--------------------------><

類似の関数については、LENGTHおよび CHARACTER_LENGTHを参照してください。

expression
任意の組み込み数値データ・タイプ、またはストリング・データ・タイプの値を戻す式。数値引数は、関数を評価する前に文字ストリングにキャストされます。 数値から文字ストリングへの変換の詳細については、VARCHARを参照してください。

この関数の結果は DECIMAL(31) になります。 引数が NULL になる可能性がある場合は、結果も NULL になる可能性があります。 引数が NULL の場合は、結果は NULL 値になります。

結果はその引数のオクテット数 (バイト数) です。 ストリングの長さには、末尾ブランクも含まれます。 可変長ストリングを指定した場合に戻る長さは、オクテット数 (バイト数) で表した実際の長さであり、最大長ではありません。

  • 表 T1 に C1 という名前の GRAPHIC(10) 列があると想定します。
      SELECT OCTET_LENGTH( C1 )
        FROM T1
    値として 20 が戻されます。