Partager via


Left, fonction (Visual Basic)

Mise à jour : novembre 2007

Retourne une chaîne contenant un nombre spécifié de caractères depuis la partie gauche d'une chaîne.

Public Shared Function Left( _
   ByVal str As String, _
   ByVal Length As Integer _
) As String

Paramètres

  • str
    Requis. Expression String à partir de laquelle les caractères situés à l'extrême gauche sont retournés.

  • Length
    Requis. Expression Integer. Expression numérique indiquant le nombre de caractères à retourner. Pour la valeur 0, une chaîne de longueur nulle ("") est retournée. Si le nombre de caractères est supérieur ou égal à celui de str, la chaîne entière est retournée.

Exceptions

Type d'exception

Numéro de l'erreur

Condition

ArgumentException

5

Length < 0.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

Pour déterminer le nombre de caractères contenus dans str, utilisez la fonction Len. Si elle est utilisée dans une application Windows Forms, ou dans toute autre classe qui a une propriété Left, vous devez attribuer un nom complet à la fonction avec Microsoft.VisualBasic.Left.

Remarque :

Dans les versions précédentes de Visual Basic, la fonction LeftB retourne une chaîne en octets à la place des caractères. Son rôle est d'abord de convertir des chaînes en applications à jeu de caractères codés sur deux octets (DBCS, Double-Byte Character Set). Toutes les chaînes Visual Basic en cours sont en Unicode et la fonction LeftB n'est plus prise en charge.

Exemple

L'exemple suivant montre l'utilisation de la fonction Left pour retourner une sous-chaîne d'une expression String donnée. Dans une classe dotée d'une propriété Left, vous devrez peut-être attribuer un nom complet à la fonction Left.

Dim TestString As String = "Hello World!"
' Returns "Hello".
Dim subString As String = Microsoft.VisualBasic.Left(TestString, 5)

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**Strings

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Voir aussi

Concepts

Récapitulatif des modifications relatives à la prise en charge des éléments de programmation

Référence

Liste des manipulations de chaînes

Right, fonction (Visual Basic)

Len, fonction (Visual Basic)

Mid, fonction (Visual Basic)

ArgumentException