Num

version 5

Num (expression) Numérique

Paramètre	Type		Description
expression	Alpha | Booléen		Chaîne à convertir en numérique ou
			Booléen à convertir en 0 ou 1
Résultat	Numérique		Valeur numérique d'une chaîne ou d'un booléen

La fonction Num retourne sous forme de numérique l'expression de type Alpha ou Booléen que vous avez passée dans le paramètre expression.

Si expression ne contient que des caractères alphabétiques, Num retourne zéro. Si expression contient des caractères alphabétiques et des caractères numériques, Num ignore les caractères alphabétiques. Ainsi, Num transformera la chaîne "a1b2c3" en nombre 123.

Note : Seuls les 32 premiers caractères de expression sont pris en compte.

Il existe trois caractères réservés que Num traite de manière particulière. Il s'agit du sépateur décimal (c'est-à-dire la virgule (,) dans une version française), du tiret (-) et du e (ou E). Ils seront interprétés en tant que caractères de formatage des nombres :

• Le séparateur décimal est interprété en tant que tel et doit être inclus dans une chaîne de caractères numériques.

• Le tiret définit un nombre ou un exposant négatif (signe moins). Le tiret doit être placé devant tout caractère numérique négatif ou derrière le e pour un exposant. Si le tiret est inclus dans une chaîne numérique, la chaîne est considérée comme invalide et la fonction Num retourne zéro. Par exemple, Num("123-456") retourne 0, mais Num("-9") retourne -9.

• Le e ou E désigne tout caractère numérique se trouvant à sa droite comme étant la puissance d'un exposant. Le e doit être inclus dans une chaîne numérique. Ainsi, Num ("123e–2") retourne 1,23.

Si vous passez une expression booléenne dans le paramètre expression, Num retourne 1 si expression est VRAI, sinon Num retourne 0.

(1) L'exemple suivant illustre la manière dont Num fonctionne lorsqu'un argument numérique lui est passé. A chaque ligne, un numérique est assigné à la variable vRésultat. Les commentaires décrivent les résultats :

   vRésultat := Num ("ABCD") ` vRésultat vaut 0 
   vRésultat := Num ("A1B2C3") ` vRésultat vaut 123 
   vRésultat := Num ("123") ` vRésultat vaut 123 
   vRésultat := Num ("123,4") ` vRésultat vaut 123,4
   vRésultat := Num ("–123") ` vRésultat vaut –123 
   vRésultat := Num ("–123e2") ` vRésultat vaut –12300

(2) Dans l'exemple suivant, [Client]Dette est comparé à la valeur 5000 (francs). La fonction Num appliquée à cette comparaison retourne 0 ou 1. La multiplication d'une chaîne par 0 ou 1 retourne soit la chaîne, soit une chaîne vide. En définitive, le champ [Client]Risque reçoit la valeur "Acceptable" ou "Inacceptable" :

      ` Si le client a des dettes inférieures à 5000, le risque est acceptable. 
      ` Si le client a des dettes supérieures à 5000, le risque est inacceptable. 
   [Client]Risque:=("Acceptable"* Num([Client]Dettes < 5000))+("Inacceptable" * Num([Client]Dettes >= 5000))

Chaine, Opérateurs logiques, Opérateurs sur les chaînes.