CHARACTER_LENGTH

文字列式の文字数を返す汎用 SQL 関数です。

Synopsis

CHARACTER_LENGTH(string-expression)

引数

string-expression

列の名前や文字リテラル、または他のスカラ関数の結果となる文字列式。基本データ型は、(CHAR や VARCHAR など) さまざまな文字タイプとして表示。

概要

CHARACTER_LENGTH は、与えられた文字列式について、そのバイト数ではなく、文字数を示す整数を返します。この数値には、先頭と末尾の空白や文字列の終了文字の数も含まれます。CHARACTER_LENGTH は、NULL 値を渡すと NULL を返し、空文字列 ('') の値を渡すと 0 を返します。

数値は、文字数がカウントされる前に解析されます。引用符に囲まれた数値文字列は解析されません。以下の例では、最初の CHARACTER_LENGTH は 1 を返し (数値の解析によって先頭と末尾の空白が削除されるため)、2 番目の CHARACTER_LENGTH は 7 を返します。

SELECT DISTINCT CHARACTER_LENGTH(007.000) AS NumLen,
     CHARACTER_LENGTH('007.000') AS NumStringLen
     FROM Sample.Employee

CHARACTER_LENGTH 関数と CHAR_LENGTH 関数は同一です。

例

以下の例は、Sample.Employee テーブルの、州の省略形フィールド (Home_State) にある文字の数を返します(米国のすべての州には 2 文字の郵便用省略形が付けられています)。

SELECT DISTINCT CHARACTER_LENGTH(Home_State) AS StateLength
     FROM Sample.Employee

以下の例は、各従業員の名前とその名前の文字数を、文字数の昇順で返します。

SELECT Name,
     CHARACTER_LENGTH(Name) AS NameLength
     FROM Sample.Employee
     ORDER BY NameLength

以下の例は、埋め込み SQL を使用して、CHARACTER_LENGTH で Unicode 文字がどのように処理されるかを示しています。CHARACTER_LENGTH では、文字のバイト長に関係なく、文字数がカウントされます。

   SET a=$CHAR(960)_"FACE"
   WRITE !,a
   &sql(SELECT CHARACTER_LENGTH(:a)
   INTO :b
   FROM Sample.Person)
   WRITE !,"Error code ",SQLCODE
   WRITE !,"The CHARACTER length is ",b

これは、5 を返します。