Fonctions de chaîne (Visual Basic)

Article
06/02/2023

Le tableau suivant répertorie les fonctions que Visual Basic fournit dans la classe Microsoft.VisualBasic.Strings pour rechercher et manipuler des chaînes. Elles peuvent être considérées comme des fonctions intrinsèques Visual Basic. Autrement dit, vous n’avez pas besoin de les appeler en tant que membres explicites d’une classe, comme le montrent les exemples. Des méthodes supplémentaires, et dans certains cas des méthodes complémentaires, sont disponibles dans la classe System.String.

Méthode .NET Framework	Description
Asc, AscW	Retourne une valeur `Integer` représentant le code de caractère correspondant à un caractère.
Chr, ChrW	Retourne le caractère associé au code de caractère spécifié.
Filter	Retourne un tableau de base zéro et contenant un sous-ensemble d'un tableau de chaînes (`String`) basé sur des critères de filtre spécifiés.
Format	Retourne une chaîne mise en forme conformément aux instructions contenues dans une expression `String` de format.
FormatCurrency	Retourne une expression sous forme de valeur monétaire utilisant le symbole monétaire défini dans le Panneau de configuration du système.
FormatDateTime	Retourne une expression de chaîne représentant une valeur de date/d'heure.
FormatNumber	Retourne une expression sous forme de nombre.
FormatPercent	Retourne une expression au format pourcentage (c’est-à-dire multipliée par 100) avec le caractère de fin %.
InStr	Retourne un entier spécifiant la position de début de la première occurrence d'une chaîne à l'intérieur d'une autre.
InStrRev	Retourne la position de la première occurrence d'une chaîne dans une autre, à partir du côté droit de la chaîne.
Join	Retourne une chaîne créée par la jonction de plusieurs sous-chaînes contenues dans un tableau.
LCase	Retourne une chaîne ou un caractère converti en lettres minuscules.
Left	Retourne une chaîne contenant un nombre spécifié de caractères en partant de la gauche d'une chaîne.
Len	Retourne un entier qui contient le nombre de caractères d’une chaîne.
LSet	Retourne une chaîne alignée à gauche contenant la chaîne spécifiée ajustée à la longueur spécifiée.
LTrim	Retourne une chaîne contenant une copie d’une chaîne spécifiée sans espaces de début.
Mid	Retourne une chaîne contenant un nombre spécifié de caractères d’une chaîne.
Replace	Retourne une chaîne dans laquelle une sous-chaîne spécifiée a été remplacée par une autre sous-chaîne, un nombre de fois déterminé.
Right	Retourne une chaîne contenant un nombre spécifié de caractères depuis la partie droite d'une chaîne.
RSet	Retourne une chaîne alignée à droite contenant la chaîne spécifiée ajustée à la longueur spécifiée.
RTrim	Retourne une chaîne contenant une copie d’une chaîne spécifiée sans espaces de fin.
Space	Retourne une chaîne composée d'un nombre spécifié d'espaces.
Split	Retourne un tableau à une dimension de base zéro et contenant le nombre spécifié de sous-chaînes.
StrComp	Retourne -1, 0 ou 1, à partir du résultat d'une comparaison de chaînes.
StrConv	Retourne une chaîne convertie comme spécifié.
StrDup	Retourne une chaîne ou un objet constitué du caractère spécifié répété le nombre de fois spécifié.
StrReverse	Retourne une chaîne dans laquelle l'ordre des caractères d'une chaîne donnée a été inversé.
Trim	Retourne une chaîne contenant une copie d’une chaîne spécifiée sans espaces de début ou de fin.
UCase	Retourne une chaîne ou un caractère contenant la chaîne spécifiée convertie en majuscules.

Vous pouvez utiliser l’instruction Option Compare pour définir si les chaînes sont comparées à l’aide d’un ordre de tri de texte qui ne respecte pas la casse, déterminé par les paramètres régionaux de votre système (Text) ou par les représentations binaires internes des caractères (Binary). La méthode de comparaison de texte par défaut est Binary.

Exemple : UCase

L'exemple suivant utilise la fonction UCase pour retourner une version en majuscules d'une chaîne.

' String to convert.
Dim lowerCase As String = "Hello World 1234"
' Returns "HELLO WORLD 1234".
Dim upperCase As String = UCase(lowerCase)

Exemple : LTrim

Cet exemple utilise la fonction LTrim pour supprimer les espaces à gauche et la fonction RTrim pour supprimer les espaces à droite d'une variable chaîne. Il utilise la fonction Trim pour supprimer les deux types d'espaces.

' Initializes string.
Dim testString As String = "  <-Trim->  "
Dim trimString As String
' Returns "<-Trim->  ".
trimString = LTrim(testString)
' Returns "  <-Trim->".
trimString = RTrim(testString)
' Returns "<-Trim->".
trimString = LTrim(RTrim(testString))
' Using the Trim function alone achieves the same result.
' Returns "<-Trim->".
trimString = Trim(testString)

Exemple : Mid

Cet exemple utilise la fonction Mid pour retourner un nombre spécifié de caractères d’une chaîne.

' Creates text string.
Dim testString As String = "Mid Function Demo"
' Returns "Mid".
Dim firstWord As String = Mid(testString, 1, 3)
' Returns "Demo".
Dim lastWord As String = Mid(testString, 14, 4)
' Returns "Function Demo".
Dim midWords As String = Mid(testString, 5)

Exemple : Len

L'exemple suivant utilise la fonction Len pour retourner le nombre de caractères d'une chaîne.

' Initializes variable.
Dim testString As String = "Hello World"
' Returns 11.
Dim testLen As Integer = Len(testString)

Exemple : InStr

L'exemple suivant utilise la fonction InStr pour retourner la position de la première occurrence d'une chaîne à l'intérieur d'une autre.

' String to search in.
Dim searchString As String = "XXpXXpXXPXXP"
' Search for "P".
Dim searchChar As String = "P"

Dim testPos As Integer
' A textual comparison starting at position 4. Returns 6.
testPos = InStr(4, searchString, searchChar, CompareMethod.Text)

' A binary comparison starting at position 1. Returns 9.
testPos = InStr(1, SearchString, SearchChar, CompareMethod.Binary)

' If Option Compare is not set, or set to Binary, return 9.
' If Option Compare is set to Text, returns 3.
testPos = InStr(searchString, searchChar)

' Returns 0.
testPos = InStr(1, searchString, "W")

Exemple : Format

L'exemple suivant illustre différentes utilisations de la fonction Format pour mettre en forme des valeurs utilisant à la fois les formats String et les formats définis par l'utilisateur. Pour le séparateur de date (/), le séparateur d'heure (:) et les indicateurs AM/PM (t et tt), le résultat réel mis en forme affiché par votre système dépend des paramètres régionaux utilisés par le code. Lorsque les heures et les dates sont affichées dans l'environnement de développement, les formats d'heure abrégée et de date courte des paramètres régionaux de code sont utilisés.

Notes

Pour paramètres régionaux configurés avec une horloge au format 24 heures, les indicateurs AM/PM (t et tt) n'affichent rien.

Dim testDateTime As Date = #1/27/2001 5:04:23 PM#
Dim testStr As String
' Returns current system time in the system-defined long time format.
testStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
testStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date 
' format, using the single letter code for the format.
testStr = Format(Now(), "D")

' Returns the value of testDateTime in user-defined date/time formats.
' Returns "5:4:23".
testStr = Format(testDateTime, "h:m:s")
' Returns "05:04:23 PM".
testStr = Format(testDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
testStr = Format(testDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
testStr = Format(testDateTime, "HH:mm:ss")
' Returns "23".
testStr = Format(23)

' User-defined numeric formats.
' Returns "5,459.40".
testStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
testStr = Format(334.9, "###0.00")
' Returns "500.00%".
testStr = Format(5, "0.00%")