# Convertir de numérique en chaîne

Convertit une valeur numérique (décimale ou hexadécimale) en chaîne.

Le nombre dans [Source Data] est converti en une chaîne au format de données (décimal ou hexadécimal) spécifié dans [Source Data Format] et stocké dans [Destination Data].

##### Bloc

##### Texte

TARGET = toString(EXPRESSION, 10, 0);
1 5 2 3/4

# | Description
1 | [Destination Data] Définissez la destination dans laquelle vous souhaitez stocker la chaîne convertie.
2 | [Source Data Format] Sélectionnez l'un des formats suivants : ##### Bloc [Decimal] : Convertit un nombre décimal en chaîne. [Hex] : Convertit un nombre hexadécimal en chaîne. ##### Texte '10' : Convertit un nombre décimal en chaîne. '16' : Convertit un nombre hexadécimal en chaîne.
3 | [Zero Suppress] ##### Bloc Cochez la case pour supprimer l'affichage de zéros au début des valeurs. Décochez la case pour spécifier le nombre de [Integer Digits] et pour ajouter des zéros au début des valeurs afin de les aligner sur le nombre de chiffres.
(Exemple) [Source Data] : 25, [Integer Digits] : 4
Lorsque la case est cochée (activée) : | 25
Lorsque la case est décochée (désactivée) : | 0025
##### Texte Définissez '0' pour supprimer l'affichage des zéros au début des valeurs. Définissez une valeur numérique entre '1' et '20' pour spécifier le nombre de [Integer Digits], et pour ajouter des zéros au début des valeurs afin de les aligner sur le nombre de chiffres.
(Exemple) [Source Data] : 25
[Integer Digits] : 0 | 25
[Integer Digits] : 4 | 0025
4 | [Integer Digits] Spécifiez le nombre de chiffres de la chaîne à convertir. Configurer la plage de valeurs : 1 - 20 Lorsque [Mode script] est [Bloc], définissez cette valeur lorsque la case [Zero Suppress] est décochée.
5 | [Source Data] Définissez la source de données dans laquelle le nombre à convertir est stocké.

(Exemple)

##### Bloc

##### Texte

Var3=toString(Var1,10,0);

## Exemple d'opération

Variable dans [Source Data] | [Zero Suppress] | [Integer Digits] | Variable dans [Destination Data] | Commentaires
Type de donnée et valeur | Format | Nombre maximum d'octets | Chaîne convertie
INT: 100 (0x64) | Decimal | Activer | - | 5 | 100 | -
- | 1 | (aucun) | Une chaîne n'est pas stockée car la chaîne convertie a dépassé le nombre maximum d'octets pouvant être stockés. Cela est considéré comme un échec dans le 'Résultat de l'opération'.
Désactiver | 4 | 5 | 0100 | '0' est ajouté pour s'aligner sur le nombre de chiffres spécifié dans [Integer Digits].
2 | 5 | 100 | Même si la valeur dépasse [Integer Digits], définit la chaîne convertie.
6 | 5 | (aucun) | Une chaîne n'est pas stockée car la chaîne convertie a dépassé le nombre maximum d'octets pouvant être stockés. Cela est considéré comme un échec dans le 'Résultat de l'opération'.
6 | Utiliser [Longueur de la variable] | 000100 | '0' est ajouté pour s'aligner sur le nombre de chiffres spécifié dans [Integer Digits].
Hex | Activer | - | 5 | 64 | -
- | 1 | (aucun) | Une chaîne n'est pas stockée car la chaîne convertie a dépassé le nombre maximum d'octets pouvant être stockés. Cela est considéré comme un échec dans le 'Résultat de l'opération'.
Désactiver | 4 | 5 | 0064 | '0' est ajouté pour s'aligner sur le nombre de chiffres spécifié dans [Integer Digits].
6 | Utiliser [Longueur de la variable] | 000064 | '0' est ajouté pour s'aligner sur le nombre de chiffres spécifié dans [Integer Digits].
INT: -100 (0xFF9C) | Decimal | Activer | - | 5 | -100 | Le signe moins '-' est pris en charge.
Désactiver | 4 | 5 | -0100 | Le signe moins '-' est pris en charge.
Hex | Activer | - | 5 | FF9C | -
REAL: 100.00 | Decimal | Activer | - | 5 | 100 | Seule la partie entière est convertie.
Hex | Activer | - | 5 | 64 | Seule la partie entière est convertie.
REAL: 100.678 | Decimal | Activer | - | 5 | 100 | Seule la partie entière est convertie.
BOOL: true | - | - | - | 5 | True (Vrai) | -
BOOL: false | - | - | - | 5 | False (Faux) | -

Remarque : même si vous définissez l'une des valeurs de type de date suivantes comme [Source Data], la valeur n'est pas convertie au format date/heure en chaîne. La valeur est convertie du format entier en une chaîne.

- DATE
- TIME
- TIME_OF_DAY
- DATE_AND_TIME

### (Exemple) Variable DATE_AND_TIME

Format Date/Heure : 8/19/2020 10:19:00 AM

Format Entier ([Source Data Format]: [Dec]) : 1597799940

Format Entier ([Source Data Format]: [Hex]) : 5F3C7E04