VBScript - Les fonctions de chaînes de caractères
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 :
|
| 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 :
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 :
|
| 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 :
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 :
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 :
|
| 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 :
|
| 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 :
|
| 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 :
|
| 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. |