Tous les produits
Search
Centre de documentation

MaxCompute:LENGTH

Dernière mise à jour :Aug 10, 2026

Calcule la longueur de la chaîne str.

Syntaxe

bigint length(string <str>)

Paramètres

str : obligatoire. Type STRING. Si l'entrée est de type BIGINT, DOUBLE, DECIMAL ou DATETIME, elle est implicitement convertie en STRING avant le calcul.

Valeur de retour

Renvoie une valeur de type BIGINT selon les règles suivantes :

  • Si str n'est pas de type STRING, BIGINT, DOUBLE, DECIMAL ou DATETIME, une erreur est renvoyée.

  • Si str vaut NULL, la fonction renvoie NULL.

  • Si str n'est pas encodé en UTF-8, la fonction renvoie -1.

Exemples

  • Exemple 1 : calculer la longueur de la chaîne Tech on the net.

    --返回15。
    select length('Tech on the net');
  • Exemple 2 : le paramètre d'entrée est NULL.

    --返回NULL。
    select length(null);

Fonctions associées

La fonction LENGTH fait partie des fonctions de manipulation de chaînes. Pour plus d'informations sur les fonctions de recherche ou de conversion de format de chaînes, consultez la section Fonctions de manipulation de chaînes.