VBScript - Les fonctions de chaînes de caractères

Décembre 2016

Les fonctions de chaînes de caractères

Fonction Description
Filter(InputStrings, Value
[, Include
[, Compare]])
Sélectionne des chaînes de caractères parmi un tableau de chaînes (InputStrings), selon les critères passés en argument. Value représente la chaîne à chercher. Include est une valeur booléenne optionnelle indiquant si la recherche doit retourner les chaînes contenant la sous-chaîne recherchée (True) ou bien celle ne contenant pas la sous-chaîne (False). Enfin compare est un argument optionnel correspondant à une valeur numérique indiquant le type de comparaison :
  • vbBinaryCompare (0) indique une comparaison binaire.
  • vbTextCompare (1) correspond à une comparaison textuelle.
FormatCurrency(Expression[,NumDigitsAfterDecimal [,IncludeLeadingDigit [,UseParensForNegativeNumbers [,GroupDigits]]]]) Retourne une valeur monétaire formatée avec le sigle monétaire défini dans le panneau de configuration du système. NumDigitsAfterDecimal est un argument optionnel précisant le nombre de chiffres à afficher après la virgule. IncludeLeadingDigit est un argument optionnel précisant si les 0 situés à la fin doivent ou non être affichés. IncludeLeadingDigit peut prendre les trois états suivants :
  • TristateTrue (-1) indique que les zéros de fin doivent être affichés ;
  • TristateFalse (0) indique que les zéros de fin doivent être masqués ;
  • TristateUseDefaults (-2) indique que les paramètres régionaux par défaut doivent être appliqués.

UseParensForNegativeNumbers est un argument optionnel précisant si les nombres négatifs doivent ou non être écrits entre parenthèses. UseParensForNegativeNumbers peut prendre les trois mêmes états que IncludeLeadingDigit.
Enfin GroupDigits est également une constante optionnelle pouvant prendre les trois mêmes états et définissant si les groupes de chiffres (milliers) doivent être séparés, pour plus de lisibilité.
FormatDateTime(Date[, NamedFormat]) Retourne une expression formatée en tant que date ou heure. L'argument optionnel NamedFormat peut prendre les valeurs suivantes :
  • vbGeneralDate (0) affiche une date et/ou une heure selon que les parties date et heure sont présentes ou non.
  • vbLongDate (1) affiche une date en utilisant le format de date long spécifié dans les paramètres régionaux du système.
  • vbShortDate (2) affiche une date en utilisant le format de date court spécifié dans les paramètres régionaux du système.
  • vbLongTime (3) affiche une heure en utilisant le format d'heure long spécifié dans les paramètres régionaux du système.
  • vbShortTime (4) affiche une heure en utilisant le format d'heure court spécifié dans les paramètres régionaux du système.
FormatNumber(Expression[,NumDigitsAfterDecimal [,IncludeLeadingDigit [,UseParensForNegativeNumbers [,GroupDigits]]]]) Retourne un nombre formaté. NumDigitsAfterDecimal est un argument optionnel précisant le nombre de chiffres à afficher après la virgule. IncludeLeadingDigit est un argument optionnel précisant si les 0 situés à la fin doivent ou non être affichés. IncludeLeadingDigit peut prendre les trois états suivants :
  • TristateTrue (-1) indique que les zéros de fin doivent être affichés ;
  • TristateFalse (0) indique que les zéros de fin doivent être masqués ;
  • TristateUseDefaults (-2) indique que les paramètres régionaux par défaut doivent être appliqués.

UseParensForNegativeNumbers est un argument optionnel précisant si les nombres négatifs doivent ou non être écrits entre parenthèses. UseParensForNegativeNumbers peut prendre les trois mêmes états que IncludeLeadingDigit.
Enfin GroupDigits est également une constante optionnelle pouvant prendre les trois mêmes états et définissant si les groupes de chiffres (milliers) doivent être séparés, pour plus de lisibilité.
FormatPercent(Expression[,NumDigitsAfterDecimal [,IncludeLeadingDigit [,UseParensForNegativeNumbers [,GroupDigits]]]]) Retourne une expression formatée en pourcentage (terminée par %). NumDigitsAfterDecimal est un argument optionnel précisant le nombre de chiffres à afficher après la virgule. IncludeLeadingDigit est un argument optionnel précisant si les 0 situés à la fin doivent ou non être affichés. IncludeLeadingDigit peut prendre les trois états suivants :
  • TristateTrue (-1) indique que les zéros de fin doivent être affichés ;
  • TristateFalse (0) indique que les zéros de fin doivent être masqués ;
  • TristateUseDefaults (-2) indique que les paramètres régionaux par défaut doivent être appliqués.

UseParensForNegativeNumbers est un argument optionnel précisant si les nombres négatifs doivent ou non être écrits entre parenthèses. UseParensForNegativeNumbers peut prendre les trois mêmes états que IncludeLeadingDigit.
Enfin GroupDigits est également une constante optionnelle pouvant prendre les trois mêmes états et définissant si les groupes de chiffres (milliers) doivent être séparés, pour plus de lisibilité.
InStr([start, ]string1, string2[, compare]) Renvoie la position de la première occurence d'une chaîne de caractères (string2) dans une autre (string1). start est un argument optionnel définissant la position du caractère à partir duquel la recherche commence.
InStrRev([start, ]string1, string2[, compare]) Renvoie la position de la première occurence d'une chaîne de caractères (string2) dans une autre (string1), en commençant par la fin.
start est un argument optionnel définissant la position du caractère à partir duquel la recherche commence.

compare est un argument optionnel correspondant à une valeur numérique indiquant le type de comparaison :

  • vbBinaryCompare (0) indique une comparaison binaire.
  • vbTextCompare (1) correspond à une comparaison textuelle.
Join(list[, delimiter]) Retourne une chaîne assemblée à partir des éléments séparés présents dans le tableau de chaînes list.
delimiter est un caractère optionnel servant à délimiter les sous-chaînes retournées dans le résultat. Par défaut les sous-chaînes sont séparées par des espaces.
LCase(string) Convertit la chaîne string en minuscules.
Left(string, length) Retourne un nombre de caractères spécifié (length) à partir de la gauche de la chaîne string.
Len(string | varname) Renvoie le nombre de caractères d'une chaîne de caractères ou le nombre d'octets nécessaires pour stocker une variable.
LTrim(string) Retourne une copie de la chaîne sans les espaces situés au début.
Mid(string, start[, length]) Renvoie un nombre spécifié (length) de caractère à partir d'une chaîne de caractères (string).
start détermine la position du caractère à partir duquel la chaîne de sortie doit commencer.
Replace(expression, find, replacewith[, start[, count[, compare]]]) Recherche et remplace une sous-chaîne dans une chaîne de caractères. expression correspond à la chaîne sur laquelle porte la recherche. find correspond à la sous-chaîne à chercher dans l'expression. replacewith correspond à la sous-chaîne devant remplacer les occurences de la sous-chaîne find dans la chaîne expression.
start, count et compare sont des arguments optionnels précisant respectivement l'emplacement du caractère à partir duquel la recherche doit commencer (par défaut 1), le nombre de substitutions à réaliser (par défaut -1 indiquant qu'il n'y a pas de limite) et le type de comparaison à effectuer.

compare est un argument optionnel correspondant à une valeur numérique indiquant le type de comparaison :

  • vbBinaryCompare (0) indique une comparaison binaire.
  • vbTextCompare (1) correspond à une comparaison textuelle.
Right(string, length) Renvoie un certain nombre de caractères (length) à partir de la droite de la chaîne string.
Rtrim(string) Retourne une copie de la chaîne sans les espaces situés à la fin.
Space(number) Retourne une chaîne de caractères constituée du nombre d'espaces passés en paramètre.
Split(expression[, delimiter[, count[, compare]]]) Retourne un tableau de chaîne unidimensionnel contenant un nombre spécifié de sous-chaînes. delimiter définit le caractère optionnel utilisé pour délimiter les sous-chaînes. Par défaut il s'agit du caractère espace (" "). count est un argument optionnel définissant le nombre maximal de sous-chaînes à retourner. Par défaut count vaut -1, indiquant qu'il n'y a pas de limite. Enfin compare est un argument optionnel indiquant le type de comparaison. Il peut posséder les valeurs suivantes :
  • vbBinaryCompare (0) indique une comparaison binaire.
  • vbTextCompare (1) correspond à une comparaison textuelle.
StrComp(string1, string2[, compare]) Retourne le résultat de la comparaison des chaînes de caractères string1 et string2. Si string1 est inférieure à string2, StrComp renvoie -1. Si string1 est égale à string2, StrComp renvoie 0. Si string1 est supérieure à string2, StrComp renvoie 1. Enfin si string1 ou string2 vaut Null, StrComp renvoie Null.

compare est un argument optionnel correspondant à une valeur numérique indiquant le type de comparaison :

  • vbBinaryCompare (0) indique une comparaison binaire.
  • vbTextCompare (1) correspond à une comparaison textuelle.
String(number, character) Retourne une chaîne de caractères de longueur number répétant le caractère character.
StrReverse(string1) Inverse l'ordre des caractères dans la chaîne string1.
Trim(string) Retourne une copie de la chaîne sans les espaces situés au début et à la fin.
UCase(string) Convertit la chaîne string en majuscules.

A voir également :

Ce document intitulé «  VBScript - Les fonctions de chaînes de caractères  » issu de CommentCaMarche (www.commentcamarche.net) est mis à disposition sous les termes de la licence Creative Commons. Vous pouvez copier, modifier des copies de cette page, dans les conditions fixées par la licence, tant que cette note apparaît clairement.