Syntaxe :
var& = CVI(chaine$)
Description :
Cette fonction convertit les octets du paramètre chaine$ en une valeur sur un entier qui a la même représentation interne que la valeur de chaine$. Si le paramètre chaine$ est constitué de 4 octets ou plus, seuls ses 4 premiers octets sont pris en considération. Si le paramètre chaine$ est constitué de 1, 2 ou 3 octets, alors CVI(chaine$) renvoie un entier sur 8, 16 ou 24 bits respectivement. Si le paramètre chaine$ est une chaîne nulle, alors CVI(chaine$) renvoie zéro.
Cette fonction est utile pour trouver la forme entière d’entités comme les types de fichier, les signatures de créateur et les types de ressource. Par exemple :
Cette fonction est utile pour trouver la forme entière d’entités comme les types de fichier, les signatures de créateur et les types de ressource. Par exemple :
ft$ = "TEXT"
leType& = CVI(ft$)
leType& = CVI(ft$)
Après exécution des lignes ci-dessus, leType& est correctement conformé pour être passé à une routine de la Toolbox qui nécessite un type de fichier comme paramètre. leType& aura également la même valeur que la constante entière _"TEXT".
La taille (en octets) de la valeur retournée par CVI dépend de la taille de chaine$. Elle ne dépend pas des réglages en cours de la commande DEFSTR BYTE/WORD/LONG. En conséquence, si vous voulez assigner la valeur retournée par CVI à une variable sur un entier court, vous devez vous assurer que chaine$ n’a pas plus de 2 octets, dans le cas contraire, vous pourriez récupérer des valeurs inattendues dans votre variable. De manière similaire, si vous voulez assigner correctement la valeur retournée par CVI à une variable sur un octet, vous devez vous assurer que le paramètre chaine$ n’a pas plus d’1 octet de longueur.
La fonction MKI$ est l’inverse de la fonction CVI. Notez, toutefois, que le résultat de MKI$ quant à lui dépend des réglages actifs de DEFSTR BYTE/WORD/LONG.
La taille (en octets) de la valeur retournée par CVI dépend de la taille de chaine$. Elle ne dépend pas des réglages en cours de la commande DEFSTR BYTE/WORD/LONG. En conséquence, si vous voulez assigner la valeur retournée par CVI à une variable sur un entier court, vous devez vous assurer que chaine$ n’a pas plus de 2 octets, dans le cas contraire, vous pourriez récupérer des valeurs inattendues dans votre variable. De manière similaire, si vous voulez assigner correctement la valeur retournée par CVI à une variable sur un octet, vous devez vous assurer que le paramètre chaine$ n’a pas plus d’1 octet de longueur.
La fonction MKI$ est l’inverse de la fonction CVI. Notez, toutefois, que le résultat de MKI$ quant à lui dépend des réglages actifs de DEFSTR BYTE/WORD/LONG.
Note :
Si chaine$ a 1 octet de longueur, alors CVI(chaine$) renvoie la même valeur que ASC(chaine$).