CBOOL

Syntaxe

Paramètres

Description

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

Remarques

• La fonction convertit une expression en valeur booléenne : La fonction CBool transforme une expression ou une valeur d'un autre type de données en une valeur logique (True ou False). Elle est utilisée lorsqu'un traitement nécessite explicitement un résultat booléen. Cette conversion facilite l'écriture de conditions et de tests dans les applications Access.
• Les valeurs numériques sont converties selon leur valeur : En règle générale, la valeur 0 est convertie en False, tandis que toute valeur différente de zéro est convertie en True. Ainsi, CBool(0) retourne False, alors que CBool(1), CBool(-1) ou CBool(100) retournent tous True. Ce comportement est cohérent avec celui du langage VBA.
• La fonction accepte différents types de données : Le paramètre peut être un nombre, une variable, une expression, un champ d'une table ou encore le résultat d'une fonction. Cette souplesse permet d'utiliser CBool dans de nombreux contextes sans devoir convertir préalablement la valeur. Il convient toutefois de s'assurer que la conversion est réellement possible.
• Une conversion impossible provoque une erreur : Si l'expression ne peut pas être interprétée comme une valeur booléenne, Microsoft Access génère une erreur d'exécution. Par exemple, certaines chaînes de caractères ou certains objets ne peuvent pas être convertis automatiquement. Il est donc recommandé de valider les données avant d'utiliser CBool sur des informations provenant d'une source externe.
• La fonction est particulièrement utile dans le code VBA : CBool est souvent utilisée dans les procédures VBA afin de convertir explicitement le résultat d'un calcul ou d'une expression avant une structure If...Then...Else. Cette conversion améliore la lisibilité du code et évite certaines ambiguïtés lors des comparaisons logiques. Elle rend également les intentions du programmeur plus claires.
• Elle peut être employée dans les requêtes et les expressions calculées : La fonction CBool n'est pas limitée aux modules VBA. Elle peut également être utilisée dans les requêtes, les formulaires, les états et les contrôles calculés d'Access. Cela permet de convertir directement des résultats numériques en valeurs logiques utilisables dans l'application.
• Elle facilite le travail avec les champs Oui/Non : Les champs de type Oui/Non d'Access sont représentés par des valeurs booléennes. La fonction CBool permet donc de convertir facilement une valeur numérique ou une expression afin de l'affecter à ce type de champ. Cette conversion simplifie les opérations de mise à jour et les calculs conditionnels.
• Il est préférable d'utiliser CBool plutôt qu'une conversion implicite : Même si VBA effectue souvent des conversions automatiques, l'utilisation explicite de CBool rend le code plus compréhensible et plus facile à maintenir. Les autres développeurs identifient immédiatement qu'une conversion vers un booléen est volontaire. Cette bonne pratique réduit également le risque d'erreurs lors de l'évolution du programme.
• La fonction fait partie de la famille des fonctions de conversion de VBA : CBool appartient au même groupe que CInt, CLng, CDbl, CDate, CStr ou CCur. Toutes ces fonctions ont pour objectif de convertir explicitement une valeur vers un type de données précis. Leur utilisation améliore la fiabilité des traitements en limitant les conversions implicites réalisées par Access.
• La fonction est compatible avec toutes les versions modernes d'Access : La fonction CBool est disponible depuis les premières versions de Microsoft Access intégrant VBA et demeure compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit un comportement uniforme lors de la migration d'applications entre différentes versions d'Access.

Exemple de code VBA

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

Par exemple :

Dans cet exemple, CBool(1=2) renverrait faux. La variable LCompare contiendrait alors la valeur false.