指定した文字列の文字数を返します。

構文

LENGTH( string-expression )

パラメータ

戻り値

INT

備考

この関数を使用すると、文字列の長さがわかります。たとえば、string-expression にカラム名を指定すると、カラムの値の長さがわかります。

文字列にマルチバイト文字があり、適切な照合が使用されている場合、LENGTH はバイト数ではなく、文字数を返します。文字列が BINARY データ型の場合、LENGTH 関数は BYTE_LENGTH 関数のように動作します。

この関数は NCHAR の入力または出力をサポートしています。

参照

• BYTE_LENGTH 関数 [文字列]
• 国際言語と文字セット
• 文字列関数

標準と互換性

例

次の文は、値 9 を返します。

SELECT LENGTH( 'chocolate' );