Alpha

Fonction

Rôle :	Conversion de numérique en alphanumérique.
Type de retour :	Alphanumérique
Notes :

 

Syntaxe1 :

Alpha (<expression numérique>)

La fonction retourne une chaîne de caractères représentant la valeur de l'expression numérique entrée.

Le résultat est rendu en prenant en compte le format de la donnée, ou un format par défaut, si le format de la donnée n'a pas été précisé.

Dans de nombreux cas, la conversion est faite implicitement : notamment dans le cas d'une affectation d'une donnée alphanumérique par une donnée numérique ou bien dans le cas de la concaténation d'une donnée alphanumérique par une donnée numérique. Le format de la valeur numérique est alors utilisé pour la conversion en alphanumérique.

Exemple:

NUM est champ numérique double. CH une variable de type Chaine.
                        BoiteMessage "La valeur est : " + NUM
                                    est équivalent à
                        BoiteMessage "La valeur est : " + Alpha(NUM)   
                        CH = NUM
                                    est équivalent à
                        CH = Alpha(NUM)
                        MAIS l'expression 120+CH (somme de 2 nombres)
                                    n'est pas équivalente à
                        l'expression Alpha(120)+CH (concaténation de 2 chaînes)

 

 

Dans le cas d'une conversion d'une expression numérique qui n'est pas une variable simple, ou un champ, le format utilisé pour la conversion est le format induit par les conversions liées à l'évaluation de l'expression.

 

Exemple 1 :

Après l'appel à la méthode JE_TESTE :

 

Syntaxe 2

Alpha (<expression>,<format d'édition>)

Cette syntaxe permet de formater une expression et de retourner le résultat sous la forme d'une chaîne alphanumérique.

L'expression peut être une variable, une donnée alphanumérique, numérique ou un champ de table numérique que l'on désire formater suivant le format d'édition choisi.

Le format d'édition est une expression alphanumérique ou simplement une chaîne constante entre guillemets. Il doit être compatible avec l'expression, c'est-à-dire être relatif à une variable de type numérique si l'expression est de type numérique, ou bien être relatif à une variable de type alphanumérique si l'expression est de type alphanumérique.

La syntaxe est la même que pour les formats d'édition des variables numériques et alphanumériques décrits dans le Manuel de référence.

 

Cas particulier: Alpha(x,"") convertit l'expression x en alphanumérique sans modification de l'éventuel format d'édition défini à la déclaration de x.

Exemple 2 :

Après l'appel à la méthode JE_TESTE1 :

Affichage du chiffre d'affaires du premier trimestre sous format monétaire avec séparateur de milliers.

Après l'appel à la méthode JE_TESTE2 :

 

Numerique