Catégories :

Fonctions de chaîne et fonctions binaires (Correspondance/Comparaison)

LEFT

Renvoie une sous-chaîne située le plus à gauche de son entrée. LEFT(STR,N) est équivalent à SUBSTR(STR,1,N).

Voir aussi :

RIGHT, SUBSTR , SUBSTRING

Syntaxe

LEFT( <string_expr> , <length_expr> )

Arguments

expr_chaîne

Cela doit être une valeur VARCHAR ou BINARY.

expr_longueur

La longueur doit être une expression dont le résultat est un entier. Elle convient d’indiquer :

  • Le nombre de caractères UTF-8 à renvoyer si l’entrée est VARCHAR.

  • Le nombre d’octets à renvoyer si l’entrée est BINARY.

La longueur doit être supérieure ou égale à zéro. Si la longueur est un nombre négatif, la fonction renvoie une chaîne vide.

Renvoie

Le type de données de la valeur renvoyée est identique à celui de la valeur d’entrée (BINARY ou VARCHAR).

Détails du classement

Le classement s’applique aux entrées VARCHAR. Le classement ne s’applique pas si le type de données en entrée du premier paramètre est BINARY.

Bien que les classements soient acceptés syntaxiquement, ils n’ont aucune incidence sur le traitement. Par exemple, les langues avec des lettres à deux caractères et à trois caractères (par exemple « dzs » en hongrois, « ch » en tchèque) comptent toujours celles-ci comme deux ou trois caractères (pas un caractère) pour l’argument de longueur.

Cependant, la valeur renvoyée conserve la spécification de classement du premier argument. Cela peut être utile si la valeur renvoyée est transmise à une autre fonction dans le cadre d’appels de fonctions imbriquées.

Exemples

SELECT LEFT('ABCDEFG', 3);

-------------------+
 LEFT('ABCDEF', 3) |
-------------------+
 ABC               |
-------------------+