STR

Syntaxe

Paramètres

Description

Cette fonction permet de convertir un nombre en chaîne de caractères.

Remarques

• La fonction convertit un nombre en chaîne de caractères : La fonction Str permet de transformer une valeur numérique en une chaîne de caractères (String). Le résultat peut ensuite être affiché, concaténé avec d'autres textes ou utilisé dans des traitements de chaînes. Cette fonction est utile lorsqu'une valeur numérique doit être manipulée comme du texte.
• Le résultat est toujours une chaîne de caractères : Après l'appel à Str, la valeur obtenue n'est plus de type numérique mais de type String. Il devient donc possible d'utiliser des fonctions telles que Left, Right, Mid, Len ou Replace sur cette valeur. En revanche, elle ne peut plus être utilisée directement dans un calcul sans être reconvertie.
• Un espace est généralement ajouté devant les nombres positifs : En VBA, Str ajoute habituellement un espace au début des nombres positifs afin d'aligner leur représentation avec celle des nombres négatifs. Par exemple, Str(25) retourne généralement " 25", tandis que Str(-25) retourne "-25". Ce comportement peut surprendre les développeurs qui découvrent cette fonction.
• La fonction Trim est souvent utilisée avec Str : Afin de supprimer l'espace ajouté devant les nombres positifs, il est courant d'utiliser Trim(Str(nombre)). Cette combinaison permet d'obtenir une chaîne sans espace superflu. Elle est très fréquente dans les applications qui construisent des messages ou des identifiants.
• Elle est différente de la fonction CStr : Bien que les deux fonctions convertissent une valeur en chaîne de caractères, CStr produit généralement une représentation plus naturelle et respecte davantage les paramètres régionaux. Str, quant à elle, est davantage orientée vers la conversion des nombres et conserve le comportement historique du langage VBA. Le choix dépend donc du résultat souhaité.
• Elle est utile pour construire des chaînes dynamiques : Str permet d'insérer facilement des valeurs numériques dans un texte. Par exemple, elle peut être utilisée pour afficher un numéro de facture, une quantité ou un montant dans un message destiné à l'utilisateur. Cette conversion facilite la création de textes personnalisés.
• Elle est disponible dans les requêtes et dans le code VBA : La fonction Str peut être utilisée dans les modules VBA ainsi que dans certaines expressions Access. Elle permet de convertir rapidement une valeur numérique en texte sans écrire de procédure spécifique. Son comportement est identique dans tous les environnements où elle est disponible.
• Elle peut être combinée avec de nombreuses fonctions de chaînes : Une fois la conversion effectuée, le résultat peut être traité avec Left, Right, Mid, Replace, Split, LCase ou UCase. Cette possibilité permet de réaliser des traitements textuels sur des données qui étaient initialement numériques. Elle offre ainsi une grande souplesse dans le développement des applications.
• Elle ne permet pas de contrôler précisément le format du résultat : Si un affichage spécifique est souhaité, par exemple avec un nombre fixe de décimales, un séparateur de milliers ou un symbole monétaire, il est préférable d'utiliser la fonction Format. Str se limite principalement à convertir une valeur numérique en texte. Les fonctions Format et CStr sont donc souvent mieux adaptées pour les présentations destinées aux utilisateurs.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction Str est disponible depuis les premières versions de Microsoft Access intégrant VBA et son fonctionnement est demeuré stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit que les applications utilisant cette fonction continueront de fonctionner correctement lors des migrations vers des versions plus récentes d'Access.

Exemple

Voyons comment utiliser la fonction Str dans Microsoft Access :

Exemple de code VBA

La fonction Str peut être utilisée dans le code VBA de Microsoft Access.

Par exemple :

Dans cet exemple, la variable appelée LResult contiendrait désormais la valeur «16».