リファレンスガイド> SQL関数のTDVサポート> 文字関数> LENGTH
 
LENGTH
LENGTHは、指定された文字列式の文字数(バイト数ではなく)を返します。
構文
LENGTH (string)
備考
CHAR_LENGTHおよびCHARACTER_LENGTHはLENGTHと同義です。
入力がNULLの場合、出力もNULLになります。それ以外の場合、出力はゼロ以上の整数になります。
入力が空の文字列の場合、出力はゼロです。
入力引数の空白の長さは1としてカウントされます。
入力文字列に含まれる空白をカウントする場合は、次の例のように、CONCAT関数を使用してスペースに対応します。
LENGTH (CONCAT (customers.ContactFirstName, CONCAT (' ', customers.ContactLastName)))
 
整数の長さを求める場合は、整数をVARCHARに変換してから、LENGTH関数の入力として文字列を渡す必要があります。
たとえば、電話番号の桁数を調べたい場合は、電話番号の整数をVARCHARにキャストし、それをLENGTH関数で使用します。
次の表に、LENGTHで使用できる入力タイプと、それに対応する出力タイプを示します。
文字列のデータタイプ
出力タイプ
BLOB、CHAR、CLOB、LONGVARCHAR、VARCHAR
INTEGER
NULL
NULL
SELECT LENGTH (customers.PostalCode) Expr1,
LENGTH (NULL) Expr2,
LENGTH (' ') Expr3,
LENGTH ('') Expr4,
LENGTH (CONCAT(customers.ContactFirstName,
        CONCAT(' ', customers.ContactLastName))) Expr5,
LENGTH (customers.FaxNumber) Expr6,
LENGTH (TO_CHAR(1000)) Expr7,
LENGTH (CAST (customers.PhoneNumber AS VARCHAR)) Expr8
FROM /shared/examples/ds_orders/customers customers