Strings.Left(String, Int32) Méthode

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb

Retourne une chaîne contenant un nombre spécifié de caractères du côté gauche d’une chaîne.

public:
 static System::String ^ Left(System::String ^ str, int Length);
public static string Left(string? str, int Length);
public static string Left(string str, int Length);
static member Left : string * int -> string
Public Function Left (str As String, Length As Integer) As String

Paramètres

str
String

Obligatoire. String expression à partir de laquelle les caractères les plus à gauche sont retournés.

Length
Int32

Obligatoire. Expression Integer. Expression numérique indiquant le nombre de caractères à renvoyer. Si elle est égale à 0, une chaîne vide ("") est renvoyée. Si elle est supérieure ou égale au nombre de caractères dans str, la chaîne entière est retournée.

Retours

String

Chaîne contenant un nombre spécifié de caractères du côté gauche d’une chaîne.

Exceptions

ArgumentException

Length < 0.

Exemples

Cet exemple illustre l’utilisation de la Left fonction pour retourner une sous-chaîne d’un donné String. Dans une classe qui a une Left propriété, il peut être nécessaire de qualifier pleinement la Left fonction.

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

Remarques

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

Note

La fonction LeftB dans les versions précédentes de Visual Basic retourne une chaîne en octets plutôt que des caractères. Elle est principalement utilisée pour convertir des chaînes dans les applications de jeu de caractères sur deux octets (DBCS). Toutes les chaînes Visual Basic actuelles sont en Unicode et LeftB n’est plus prise en charge.

S’applique à

Voir aussi