Manuel des Scripts Automation Engine > Organisation fonctionnelle > Chaînes de caractères > CONVERT

CONVERT

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

Syntaxe

CONVERT (type de données, valeur)

Elément de syntaxe

Description/format

Type de données

Type de données dans lequel la conversion doit être effectuée.
Valeurs autorisées : "unsigned", "signed", "float" et "string"

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

L'indication des types de données s'effectue sans guillemet !

Valeur

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 chiffres doivent également être indiqués entre guillemets !

Code retour

Valeur avec le type de données converti.

Remarques

La fonction script permet de convertir le type de données d'une valeur qui est indiquée soit directement, soit via une Variable de script en un autre type de données. Le code de retour est la valeur reconvertie devant être attribuée à une Variable cible.

Attention : en utilisant cette fonction script, veillez à ce que le type de données de la valeur à convertir corresponde au type de données de la Variable cible.

Les chaînes de caractères peuvent uniquement être converties en chiffres si la chaîne contient un nombre dans un format valide !"

Si une tentative de convertir un type de données supérieur en un type inférieur est effectuée, les nombres décimaux seront arrondis ou les signes supprimés.

Si le type de données de la Variable cible ne correspond pas au paramètre "Type de données" de la fonction, la conversion est impossible et une erreur de script apparaît !

Attention : la fonction de script ne permet pas de convertir les nombres négatifs !

Exemple

Dans le premier exemple, un nombre entier positif est converti en une chaîne de caractères.

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

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

Dans le deuxième exemple, une chaîne de caractères est convertie en un nombre. Ceci est uniquement possible si la chaîne de caractères est composée d'un nombre qui présente un format valide pour le type de données cible.

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

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

Rubriques connexes :

Elément de script - Traitement d'objets

Importation et exportation d'objets

Généralités sur les scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle