CONVERT

Fonction de script : Convertit le type de données d'une valeur.

Syntaxe

CONVERT (Data type, value)

Syntaxe

Description / format

Data type

Type de données pour lequel une conversion est nécessaire.
Valeurs autorisées : "unsigned", "signed", "float" et "string"

unsigned : entiers positifs sans signe
signed : entiers avec signe
float : nombre à virgule flottante
string : chaîne de caractères, texte

Les types de données sont indiqués sans apostrophe.

Value

Valeur dont le type de données doit être converti en un autre type de données.

Format : littéral de script ou variable de script

Les nombres doivent être également spécifiés entre apostrophes.


Code retour

Valeur incluant le type de données converti.

Vous pouvez utiliser une fonction de script pour convertir le type de données d'une valeur spécifiée directement ou via une variable de script, en un type de données différent. Le code retour est la valeur convertie à affecter à la variable cible.

Veillez à ce que le type de données de la valeur à convertir corresponde à celui de la variable cible lorsque vous utilisez cette fonction de script.

Les chaînes de caractères ne peuvent être converties en nombres que si elles incluent un nombre dans un format valide.

Si vous tentez de convertir un type de nombre supérieur en un type inférieur, les nombres décimaux seont arrondis ou les signes supprimés.

La conversion est impossible si le type de données de la variable cible ne correspond pas au paramètre "Type de données » de la fonction. On obtient alors une erreur de script.

Notez que cette fonction de script ne permet pas de convertir des nombres négatifs

Exemple

Le premier exemple illustre la conversion d'un entier positif en chaîne de caractères.

:define &unsigned#, unsigned
:define &string#, string

:set &unsigned# = 12
:set &string# = CONVERT(string, &unsigned#)

Le second exemple convertir une chaîne de caractères en nombre. Cela n'est possible que si la chaîne de caractères se compose d'un nombre au format valide pour le type de données cible.

:define &unsigned#, unsigned
:define &string#, string

:set &string# = "1234"
:set &unsigned# = CONVERT(unsigned,&string#)

Voir aussi :