Syntaxe
GAUCHE(Chaîne,Longueur)
Description
La fonction scalaire SQL GAUCHE renvoie les caractères situés le plus à gauche dans la chaîne, en fonction du nombre indiqué.
Le résultat est une chaîne de caractères.
Si un argument quelconque de la fonction GAUCHE peut être nul, le résultat peut l'être également.
Si un argument quelconque est nul, le résultat l'est aussi.
Paramètres
Chaîne |
Argument qui identifie la chaîne dont est issu le résultat. Chaîne doit correspondre à une chaîne de caractères. Une sous-chaîne de Chaîne correspond à zéro ou à plusieurs octets contigus de l'argument Chaîne.
|
Longueur |
Argument qui définit la longueur du résultat. L'argument Longueur doit correspondre à un nombre entier binaire compris entre 0 et n, où n correspond à l'attribut de longueur de l'argument Chaîne. Toutefois, il ne doit pas être égal à la constante entière 0.
L'argument Chaîne est complété sur la droite avec le nombre de caractères blancs suffisant pour que la sous-chaîne de Chaîne existe toujours.
Si l'argument Longueur est défini par une constante entière, le résultat est une chaîne de longueur fixe. Dans tous les autres cas, le résultat est une chaîne de longueur variable avec un attribut de longueur identique à l'attribut de longueur de Chaîne. Le résultat d'une fonction basée sur GAUCHE sera toujours une chaîne de longueur variable. |
Par exemple
Soit la variable hôte NOM (ALPHA(50)) possédant la valeur 'SERGE DUPAIN' et la variable LONG_NOM (NUM_BIN_4) égale à 5.
GAUCHE(:NOM, :LONG_NOM)
La fonction renvoie la valeur 'SERGE'.
