CVAR

Syntaxe

Paramètres

Description

Cette fonction permet de convertir un type de données quelconque à un format de variante.

Remarques

• La fonction convertit une expression en type Variant : La fonction CVar transforme une expression en une valeur de type Variant, qui est le type de données le plus polyvalent du langage VBA. Un Variant est capable de contenir différents types de données, tels que des nombres, des dates, du texte ou des valeurs booléennes. Cette flexibilité en fait un type très utilisé dans les applications Access.
• Le type Variant peut entreposer plusieurs types de données : Contrairement aux types Integer, Double ou String, un Variant n'est pas limité à un seul format de données. Il peut contenir une valeur numérique, une chaîne de caractères, une date ou même la valeur Null. Cette caractéristique facilite la manipulation de données dont le type n'est pas connu à l'avance.
• La fonction est souvent utilisée lors de la programmation générique : CVar est particulièrement utile lorsque le développeur écrit des procédures capables de traiter plusieurs types de données différents. Une même variable peut alors recevoir successivement un entier, une chaîne de caractères ou une date sans provoquer d'erreur de type. Cette approche simplifie le développement de fonctions réutilisables.
• La conversion ne modifie généralement pas la valeur de l'expression : Dans la plupart des cas, CVar ne change pas le contenu de la donnée, mais uniquement son type d'entreposage. Ainsi, un nombre reste un nombre et une date reste une date, mais ils sont désormais encapsulés dans un objet de type Variant. Cette conversion est donc essentiellement destinée à rendre la valeur plus flexible.
• Le type Variant occupe davantage de mémoire : En raison de sa capacité à entreposer différents types de données, un Variant nécessite plus d'espace mémoire qu'un type spécialisé comme Integer ou Double. Pour cette raison, il est généralement conseillé d'utiliser un type spécifique lorsque le type de la donnée est connu à l'avance. CVar est surtout utile lorsque cette information n'est pas disponible ou peut varier.
• La fonction facilite le passage de paramètres entre procédures : Certaines procédures VBA acceptent des paramètres de type Variant afin de pouvoir recevoir des valeurs de différents types. CVar permet alors de convertir explicitement une expression avant son passage à la procédure. Cette pratique améliore la compatibilité entre différentes fonctions ou bibliothèques.
• Elle peut être utilisée dans les requêtes et dans le code VBA : La fonction CVar est disponible dans les modules VBA ainsi que dans certaines expressions utilisées dans les requêtes, les formulaires et les états Access. Elle permet d'obtenir un résultat de type Variant directement lors de l'évaluation d'une expression. Cette polyvalence facilite le développement d'applications utilisant des données de nature variée.
• Elle appartient à la famille des fonctions de conversion de VBA : CVar fait partie des fonctions de conversion telles que CBool, CByte, CCur, CDate, CDbl, CDec, CInt, CLng, CSng et CStr. Alors que ces dernières convertissent vers un type bien précis, CVar produit un type générique capable de représenter plusieurs catégories de données. Elle constitue donc une fonction particulière au sein de cette famille.
• Son utilisation doit rester justifiée : Bien que le type Variant soit très pratique, son utilisation systématique peut rendre le code plus difficile à comprendre et légèrement moins performant. Lorsque le type de données est connu, il est généralement préférable d'utiliser une fonction de conversion spécialisée comme CInt ou CDbl. CVar doit être réservée aux situations où la flexibilité est réellement nécessaire.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction CVar est disponible depuis les premières versions de Microsoft Access intégrant VBA et son comportement est demeuré stable au fil des versions. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette compatibilité garantit que les applications utilisant des variables de type Variant continuent de fonctionner correctement après une migration vers une version plus récente d'Access.

Exemple de code VBA

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

Par exemple :

La variable appelée LValue contiendrait désormais la valeur variante «8».