CStr

Renvoie une expression qui a été convertie en un Variant de sous-type String.

Structure

CStr(expression)

Paramètres

L'argument expression peut être n'importe quelle expression valide.

Description

En général, vous pouvez documenter votre code à l'aide des fonctions de conversion de types de données afin d'indiquer que le résultat d'une opération donnée doit être exprimé sous un type de données particulier plutôt que sous le type de données par défaut. Par exemple, utilisez CStr pour forcer le résultat à être exprimé sous forme de chaîne de caractères.

Il est recommandé d'utiliser la fonction CStr à la place de Str pour effectuer des conversions respectueuses des normes internationales depuis n'importe quel autre type de données vers un sous-type de chaîne de caractères. Par exemple, les 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'expression déterminent la valeur renvoyée, conformément au tableau suivant :

Si l'expression est de type CStr, la fonction renvoie une chaîne de caractères (

) ou une valeur booléenne (Boolean) contenant « True » ou « False ».

Date : une chaîne de caractères contenant une date au format court utilisé par votre système.

Null Une erreur d'exécution.

Vide : une chaîne de caractères de longueur nulle ('').

Erreur : une chaîne de caractères contenant le mot « Erreur » suivi du numéro d'erreur.

Autre valeur numérique : une chaîne de caractères contenant le nombre.

Exemple

L'exemple suivant utilise la fonction CStr pour convertir une valeur numérique en chaîne de caractères :

Dim MyDouble, MyString

; MyDouble = 437,324 ' MyDouble est un Double.

MyString = CStr(MyDouble) ' MyString contient « 437,324 ». |