Num

4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant

version 5


Num (expression) Numérique

ParamètreTypeDescription
expressionAlpha | BooléenChaîne à convertir en numérique ou
Booléen à convertir en 0 ou 1
RésultatNumériqueValeur numérique d'une chaîne ou d'un booléen

Description

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.

Expressions de type Alpha

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. Hormis le cas du caractère e, si le tiret est inclus dans une chaîne numérique, la partie de la chaîne se trouvant derrière le tiret est ignorée. Par exemple, Num("123-456") retourne 123, 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.

A noter que dans le cas où la chaîne comporte plus d'un caractère e, la conversion pourra donner des résultats différents sous Mac OS et sous Windows.

Expressions de type Booléen

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

Exemples

(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 1000. 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 à 1000, le risque est acceptable. 
      ` Si le client a des dettes supérieures à 1000, le risque est inacceptable. 
   [Client]Risque:=("Acceptable"* Num([Client]Dettes < 1000))+("Inacceptable" * Num([Client]Dettes >= 1000))

Référence

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


4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant