STR

Syntaxe

Paramètres

Description

Cette fonction transforme une valeur numérique en chaîne de caractères.

Remarques

• La fonction STR permet de convertir une valeur numérique (entier, réel,...) en une chaîne de caractères (String) de manière directe. Elle est particulièrement utile lorsqu'on veut concaténer des nombres dans du texte, sans devoir utiliser une conversion manuelle plus complexe.
• La syntaxe Function STR(n As Variant) As String indique que le paramètre peut être de type Variant, ce qui rend STR très flexible. Cela signifie que la fonction peut accepter différents types numériques (Integer, Double, Currency,...) sans qu'il soit nécessaire de préciser leur type exact au préalable.
• Une particularité importante de STR est qu'elle insère systématiquement un espace devant les nombres positifs pour aligner correctement les résultats avec les nombres négatifs. Cela peut surprendre lors de l'affichage mais est pratique pour aligner des colonnes de nombres dans des affichages en texte brut.
• Si l'on ne veut pas de cet espace supplémentaire avant les nombres positifs, il faut soit utiliser la fonction CStr, soit supprimer manuellement l'espace en appliquant par exemple Trim(Str(n)). C'est un détail souvent ignoré mais qui peut avoir un impact visuel important dans les interfaces ou les exports texte.
• Le fait que STR convertisse aussi bien des petits nombres que des très grands sans perte de précision en fait un outil fiable pour générer des documents texte dynamiques à partir de données numériques, comme des factures, des rapports ou des journaux d'événements.
• L'exemple donné montre une conversion basique d'un entier (2010) en chaîne, mais STR gère aussi correctement les nombres à virgule flottante. Par exemple, Str(12.34) produira " 12.34", conservant ainsi les décimales importantes dans la conversion.
• Attention : si la variable passée à STR n'est pas numérique (par exemple une chaîne alphabétique), une erreur d'exécution sera levée. Il est donc conseillé de s'assurer que la variable est bien numérique avant d'utiliser STR, surtout si les données sont issues d'entrées utilisateur.
• Dans les projets modernes de Visual Basic, d'autres fonctions comme Format, FormatNumber, ou CStr sont parfois préférées pour leur contrôle plus fin du formatage. Néanmoins, STR reste un choix rapide et efficace pour des conversions simples et standards sans mise en forme sophistiquée.

Exemple

Voici un exemple d'une utilisation typique de cette fonction :

on obtiendra le résultat suivant :