Renvoie une donnée de type Variante (Chaîne) contenant un nombre défini de caractères du côté gauche d’une chaîne.
Syntaxe
Left(chaîne, longueur)
La syntaxe de la fonction Gauche contient les arguments suivants :
| Argument | Description |
|---|---|
| chaîne | Obligatoire. Expression de chaîne de laquelle les caractères les plus à gauche sont renvoyés. Si la chaîne contient Null, la valeur Null est renvoyée. |
| Longueur | Obligatoire. Variante (longue). expression numérique indiquant le nombre de caractères à renvoyer. Si elle est égale à 0, une chaîne vide ("") est renvoyée. Si ce nombre est supérieur ou égal au nombre de caractères de la chaîne, la chaîne entière est retournée. |
Remarques
Pour déterminer le nombre de caractères d’une chaîne, utilisez la fonction Len .
Remarque
Utilisez la fonction LeftB avec des données octet contenues dans une chaîne. Au lieu de spécifier le nombre de caractères à renvoyer, length spécifie le nombre d’octets.
Exemple de requête
| Expression | Résultats |
|---|---|
| SELECT Left(ProductID,3) AS FromLeft FROM ProductSales ; | Renvoie les caractères « 3 » du côté gauche des valeurs du champ « IDProduit » de la table « ProductSales » dans la colonne FromLeft. |
Exemple de VBA
Remarque
Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence développeur dans la liste déroulante en regard de Rechercher , puis entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple utilise la fonction Gauche pour renvoyer un nombre spécifié de caractères à partir du côté gauche d’une chaîne.
Dim AnyString, MyStr
AnyString = "Hello World" ' Define string.
MyStr = Left(AnyString, 1) ' Returns "H".
MyStr = Left(AnyString, 7) ' Returns "Hello W".
MyStr = Left(AnyString, 20) ' Returns "Hello World".