CByte

Syntaxe

Paramètres

Description

Cette fonction permet de convertir une expression en un type octet (Byte).

Remarques

• La fonction CByte est utilisée pour convertir une expression numérique en une valeur de type Byte, c'est-à-dire un entier compris entre 0 et 255. Elle est utile lorsqu'on souhaite garantir que la donnée tient dans un seul octet.
• Le paramètre n doit représenter une valeur numérique valide. Si la valeur est inférieure à 0 ou supérieure à 255, ou si elle est non numérique, VBScript génère une erreur d'exécution.
• Avant de procéder à la conversion, CByte arrondit la valeur si elle n'est pas entière. Par exemple, CByte(100.9) renverra 101. Cela peut produire des résultats inattendus si l'on ne souhaite pas de conversion implicite des décimales.
• Cette fonction est très utile lorsqu'on travaille avec des données binaires ou des flux réseau, où les valeurs doivent être exprimées en octets pour correspondre à un protocole ou un format précis.
• En raison de son intervalle de valeurs restreinte (0 à 255), l'utilisation de CByte peut aider à économiser de la mémoire dans certains cas, notamment lors du traitement de grands tableaux de petites valeurs.
• Si n est une chaîne de caractères contenant une valeur numérique (par exemple "42"), VBScript tente d'abord de la convertir en nombre, puis en octet. Cela permet une certaine souplesse dans les types d'entrée.
• Il est important de noter que CByte ne gère pas les types booléens directement. Si on lui passe True ou False, ceux-ci seront convertis en -1 et 0 respectivement avant la conversion, ce qui peut poser problème car -1 est hors intervalle.
• En résumé, CByte est particulièrement adapté aux scénarios où la précision n'est pas critique (car il arrondit) et où la plage des valeurs est strictement contrôlée. Sa mauvaise utilisation peut entraîner des erreurs discrètes, surtout dans des conversions implicites.