Partager via


Fonctions de chaîne (Visual Basic)

Le tableau suivant répertorie les fonctions fournies par Visual Basic pour rechercher et manipuler des chaînes.

Méthode .NET Framework

Description

Asc, AscW

Retourne une valeur de type Integer qui représente 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 formatée 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 à 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 contenant le nombre de caractères dans 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 à gauche.

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 à droite.

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 à gauche ni à droite.

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 selon un ordre de tri de texte non sensible à 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

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)

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)

L'exemple suivant utilise la fonction Mid pour retourner un nombre spécifié de caractères à partir 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)

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)

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")

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%")

Voir aussi

Référence

Membres de la bibliothèque runtime Visual Basic

Liste des manipulations de chaînes (Visual Basic)

Autres ressources

Mots clés (Visual Basic)