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