CStr, fonction

Microsoft VBScript

Microsoft® Visual Basic® Scripting Edition CStr, fonction Référence du langage 
Version 1 

Voir aussi


Description
Renvoie une expression qui a été convertie en un Variant de sous-type String.
Syntaxe
CStr(expression)

L'argument expression représente toute expression valide.

Notes
En général, vous pouvez documenter votre code en utilisant des fonctions de conversion des types de données pour indiquer que le résultat d'une opération doit être exprimé sous forme d'un type de données particulier plutôt que sous la forme du type de données par défaut. Par exemple, utilisez la fonction CStr pour forcer le résultat à être exprimé sous forme d'un sous-type String.

Vous devez utiliser la fonction CStr à la place de Str pour fournir des conversions reconnues au niveau international de tout autre type de données en sous-type String. Par exemple, différents séparateurs décimaux sont correctement reconnus en fonction des paramètres régionaux de votre système.

Les données contenues dans l'argument expression déterminent ce qui est renvoyé conformément au tableau suivant:

Si expression est La fonction CStr renvoie
Boolean Un String contenant True ou False.
Date Un String contenant une date dans le format court de votre système.
Null Une erreur d'exécution.
Empty Un String de longueur nulle ("").
Error Un String contenant le mot Erreur suivi d'un numéro d'erreur.
Autre élément numérique Un String contenant le nombre.

L'exemple ci-dessous utilise la fonction CStr pour convertir une valeur numérique en String (chaîne) :

Dim MyDouble, MyString
MyDouble = 437,324         ' MyDouble est un Double.
MyString = CStr(MyDouble)  ' MyString contient "437,324".