BCDTOINT

La fonction BCDTOINT convertit un article du format BCD (Binary Coded Decimal) au format entier.

Le format de la valeur binaire renvoyée est natif pour la machine sur laquelle la mappe est exécutée.

Syntaxe :
BCDTOINT (expression-texte-unique , expression-entier-unique)
Signification :
BCDTOINT (élément_BCD_à_convertir, longueur_de_sortie)
Renvoie :
Un nombre binaire unique

BCD_item_to_convert est converti du format BCD (binary coded decimal) vers sa valeur d'entier.

Les nombres au format BCD comportent deux chiffres décimaux dans chaque octet. Chaque demi-octet peut donc contenir une valeur binaire comprise entre 0000 (qui représente le chiffre 0) et 1001 (qui représente le chiffre 9). Sur la base de cette définition, le comportement suivant est applicable :

  • Si un demi-octet du nombre BCD contient les valeurs binaires 1101 ou 1111, ce demi-octet n'est pas pris en compte.
  • Si un demi-octet contient les valeurs binaires 1010, 1011, 1100 ou 1110, la sortie de la fonction est "none".

La longueur du nombre binaire en sortie est spécifiée par length_of_output. La longueur doit être 1, 2 ou 4. Si une autre valeur est utilisée, la longueur prise en compte est 2.

BCDTOINT renvoie une valeur binaire dont la forme est native de la machine sur laquelle la mappe est exécutée. La valeur peut donc être utilisée dans des opérations arithmétiques ou comparée à d'autres valeurs numériques. Elle ne doit pas être utilisée pour les manipulations de bits car l'ordre des octets dans le nombre dépend du système d'exploitation sur lequel la mappe est exécutée. Par exemple, sur un PC, l'octet de poids faible est le premier alors que sur un grand système, l'octet de poids fort est le premier.

Exemples

  • BCDTOINT ( bcdAmount Field, 2 )

    Si bcdAmount Field contient x'37' au format BCD, cet exemple renvoie la valeur d'entier 37.

Fonctions associées

  • BCDTOTEXT
  • BCDTOHEX
  • TEXTTOBCD