Partager via

Fonctions de chaîne (Visual Basic)

Le tableau suivant répertorie les fonctions que Visual Basic fournit dans la Microsoft.VisualBasic.Strings classe 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 System.String classe.

Méthode .NET Framework Descriptif
Asc, AscW Retourne une Integer valeur 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 contenant un sous-ensemble d’un String tableau en fonction des critères de filtre spécifiés.
Format Retourne une chaîne mise en forme en fonction des instructions contenues dans une expression de format String .
FormatCurrency Retourne une expression mise en forme sous forme de valeur monétaire à l’aide du symbole monétaire défini dans le panneau de configuration système.
FormatDateTime Retourne une expression de chaîne représentant une valeur de date/heure.
FormatNumber Retourne une expression mise en forme sous forme de nombre.
FormatPercent Renvoie une expression mise en forme sous forme de pourcentage (c’est-à-dire multipliée par 100) avec un caractère de fin %.
InStr Retourne un entier spécifiant la position de début de la première occurrence d’une chaîne dans une autre.
InStrRev Retourne la position de la première occurrence d’une chaîne dans une autre, en commençant à partir du côté droit de la chaîne.
Join Retourne une chaîne créée en joignant un certain nombre de sous-chaînes contenues dans un tableau.
LCase Retourne une chaîne ou un caractère converti en minuscules.
Left Retourne une chaîne contenant un nombre spécifié de caractères du côté 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 spécifié de fois.
Right Retourne une chaîne contenant un nombre spécifié de caractères du côté droit 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 du nombre spécifié d’espaces.
Split Retourne un tableau unidimensionnel de base zéro contenant un nombre spécifié de sous-chaînes.
StrComp Retourne -1, 0 ou 1, en fonction 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 de caractères d’une chaîne spécifiée est 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

Cet exemple utilise la UCase fonction pour retourner une version majuscule 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 LTrim fonction pour supprimer des espaces de début et la RTrim fonction pour supprimer des espaces de fin à partir d’une variable de chaîne. Il utilise la Trim fonction 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 Mid fonction 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

Cet exemple utilise Len pour renvoyer le nombre de caractères dans une chaîne.

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

Exemple : InStr

Cet exemple utilise la InStr fonction pour retourner la position de la première occurrence d’une chaîne dans 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

Cet exemple montre différentes utilisations de la Format fonction pour mettre en forme des valeurs à l’aide de String formats et de 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), la sortie mise en forme réelle affichée par votre système dépend des paramètres régionaux que le code utilise. Lorsque les heures et les dates sont affichées dans l’environnement de développement, le format de temps court et le format de date courte des paramètres régionaux du code sont utilisés.

Remarque

Pour les paramètres régionaux qui utilisent une horloge de 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%")

Voir aussi

  • Last updated on