LENGTH

LENGTH 関数は、値の長さを戻します。

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

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

expression
任意の組み込みデータ・タイプの値を戻す式。

この関数の結果は長精度整数になります。 引数が NULL になる可能性がある場合は、結果も NULL になる可能性があります。 引数が NULL の場合は、結果は NULL 値になります。

結果は、引数の長さです。ストリングの長さには、ブランクも含まれます。 可変長ストリングの長さは、長さ属性ではなく実際の長さです。

漢字ストリングの長さは、 2 バイト文字の数 (バイト数を 2 で除算した値) になります。 その他のすべての値の長さは、その値を表すのに使用するバイト数になります。

  • 短精度整数の場合は 2
  • 長精度整数の場合は 4
  • 64 ビット整数の場合は 8
  • 精度が p のパック 10 進数の場合は (p/2)+1 の整数部分
  • 精度が p のゾーン 10 進数の場合は p
  • 単精度浮動小数点の場合は 4
  • 倍精度浮動小数点の場合は 8
  • DECFLOAT(16) の場合は 8
  • DECFLOAT(34) の場合は 16
  • ストリングの場合はストリングの長さ
  • 時刻の場合は 3
  • 日付の場合は 4
  • timestamp(p) の場合は 7+(p+1)/2
  • データ・リンクの場合はデータ・リンク値を保管するために実際に使用するバイト数 (データ・リンクが FILE LINK CONTROL で、 しかも READ PERMISSION DB の場合は、これに 19 を加える)。
  • 行 ID の場合は 26

例

  • ホスト変数 ADDRESS は、値が‘895 Don Mills Road' の可変長文字ストリングであると想定します。 
      SELECT LENGTH(:ADDRESS)
    FROM SYSIBM.SYSDUMMY1
    値 18 が戻されます。
  • PRSTDATE が、DATE タイプの列であるとします。 
      SELECT LENGTH(PRSTDATE)
    FROM PROJECT
    値として 4 が戻されます。
  • PRSTDATE が、DATE タイプの列であるとします。 
      SELECT LENGTH(CHAR(PRSTDATE, EUR))
    FROM PROJECT
    値として 10 が戻されます。
親トピック: スカラー関数