CBYTE

Syntaxe

Paramètres

Description

Cette fonction permet de convertir un type de données quelconque à un format Octet (soit un nombre entre 0 et 255).

Remarques

• La fonction convertit une expression en type Octet (Byte) : La fonction CByte transforme une expression numérique ou une valeur compatible en un entier non signé de type Byte. Le résultat obtenu est toujours compris entre 0 et 255 inclusivement. Cette fonction est utile lorsqu'une valeur doit être entreposée ou manipulée sous la forme d'un octet.
• La plage de valeurs est strictement limitée : Contrairement aux types Integer ou Long, le type Byte ne peut contenir que des valeurs comprises entre 0 et 255. Si la valeur à convertir est inférieure à 0 ou supérieure à 255, Access génère une erreur de dépassement de capacité (Overflow). Il est donc recommandé de vérifier les bornes avant d'effectuer la conversion.
• La fonction effectue un arrondi des valeurs décimales : Lorsque l'expression contient un nombre décimal, CByte effectue un arrondi vers l'entier le plus proche avant de réaliser la conversion. Par exemple, CByte(12,6) retourne 13, tandis que CByte(12,4) retourne 12. Ce comportement diffère des fonctions Int ou Fix, qui tronquent les décimales.
• Elle accepte différents types de données compatibles : Le paramètre peut être une constante numérique, une variable, un champ de table ou une expression arithmétique. Dans certains cas, une chaîne de caractères représentant un nombre peut également être convertie avec succès. En revanche, une chaîne ne contenant pas une valeur numérique provoquera une erreur de conversion.
• La fonction est utile pour optimiser l'utilisation de la mémoire : Le type Byte occupe seulement 1 octet en mémoire, ce qui est moins que les types Integer ou Long. Lorsque les valeurs manipulées sont toujours comprises entre 0 et 255, utiliser CByte peut contribuer à réduire la consommation mémoire d'une application. Cet avantage devient intéressant lorsque de très grandes quantités de données sont traitées.
• Elle est fréquemment utilisée pour manipuler des couleurs et des données binaires : Les composantes Rouge, Vert et Bleu d'une couleur sont généralement représentées par des valeurs comprises entre 0 et 255. La fonction CByte est donc particulièrement adaptée aux calculs graphiques ou à la manipulation de données binaires. Elle peut également servir lors du traitement de fichiers contenant des octets individuels.
• Une conversion invalide provoque une erreur d'exécution : Si la valeur fournie ne peut pas être convertie en octet, Access génère une erreur. C'est notamment le cas lorsqu'une valeur est négative, dépasse 255 ou contient des caractères non numériques. Pour éviter ce type de problème, il est conseillé de vérifier les données avec IsNumeric ou d'utiliser une gestion des erreurs en VBA.
• Elle fait partie des fonctions de conversion du langage VBA : CByte appartient à la même famille que CBool, CInt, CLng, CSng, CDbl, CCur, CDate et CStr. Toutes ces fonctions permettent d'effectuer des conversions explicites entre les différents types de données pris en charge par Microsoft Access. Leur utilisation améliore la lisibilité et la robustesse du code.
• Elle peut être utilisée aussi bien dans les requêtes que dans le code VBA : La fonction CByte est disponible dans les modules VBA, mais également dans les expressions des requêtes, des formulaires et des états. Elle permet ainsi de convertir des valeurs directement lors de l'exécution d'une requête ou dans un contrôle calculé. Cette polyvalence évite souvent d'avoir à écrire du code supplémentaire.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : CByte est présente dans Access depuis de nombreuses versions et son comportement est demeuré stable au fil du temps. 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é facilite la migration d'applications développées sur d'anciennes versions d'Access.

Exemple de code VBA

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

Par exemple :

Dans cet exemple, la variable LCompare contiendrait maintenant la valeur d'octet 12.