すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:LENGTH

最終更新日:Jan 17, 2025

文字列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は文字列関数です。 文字列検索と変換に関連する関数の詳細については、文字列関数.