Partager via


Strings.Left(String, Int32) Méthode

Définition

Retourne une chaîne contenant un nombre spécifié de caractères en partant de la 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. Expression String dont les caractères situés le plus à gauche sont retournés.

Length
Int32

Obligatoire. Expression Integer. Expression numérique indiquant le nombre de caractères à retourner. Si ce paramètre a la valeur 0, une chaîne de longueur nulle ("") est retournée. Si sa valeur est supérieure ou égale au nombre de caractères de str, la chaîne est retournée dans son intégralité.

Retours

Une chaîne contenant un nombre spécifié de caractères en partant de la gauche d’une chaîne.

Exceptions

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 entièrement 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 Left propriété, vous devez qualifier entièrement la fonction avec Microsoft.VisualBasic.Left.

Notes

La LeftB fonction dans les versions précédentes de Visual Basic retourne une chaîne en octets plutôt qu’en 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 ne sont plus prises en charge.

S’applique à

Voir aussi