文字列strの長さを返します。
構文
bigint length(string <str>)パラメーター
str: 必須です。 STRING型の値。 入力値がBIGINT型、DOUBLE型、DECIMAL型、またはDATETIME型の場合、計算前に値は暗黙的にSTRING型の値に変換されます。
戻り値
BIGINT型の値が返されます。 戻り値は、次のルールによって異なります。
strの値がSTRING、BIGINT、DOUBLE、DECIMAL、またはDATETIME型でない場合、エラーが返されます。
strの値がnullの場合、nullが返されます。
strの値がUTF-8エンコードされていない場合、-1が返されます。
例
例1: 文字列の長さ
Tech on the netを返します。 例:-- The return value is 15. select length('Tech on the net');例2: 入力パラメーターをnullに設定します。 例:
-- The return value is null. select length(null);
関連関数
LENGTHは文字列関数です。 文字列検索と変換に関連する関数の詳細については、文字列関数.