# Extraire la chaîne (gauche/droite)

Extrait une chaîne du bord gauche ou droit.

##### Bloc

##### Texte

TARGET = substringFromLeft(INPUT, COUNT);
1 2 4 3

# | Description
1 | [Destination Data] Définissez la destination dans laquelle vous souhaitez stocker la chaîne extraite.
2 | Direction pour extraire la chaîne de caractères ##### Bloc [FromLeft] [FromRight] ##### Texte 'substringFromLeft' 'substringFromRight' Sélectionnez la direction utilisée pour extraire la chaîne. (Exemple) Chaîne : "ABCDE", [Number of characters] : 3 caractères Red sont extraits. Lorsque [FromLeft] est sélectionné : ABC DE Lorsque [FromRight] est sélectionné : AB CDE
3 | [Number of characters] Définissez un bloc qui spécifie le nombre de caractères à extraire. La valeur doit être supérieure ou égale à 1 et inférieure ou égale au nombre de caractères pouvant être extraits. Les caractères codés sur deux octets sont comptés comme un seul caractère.
4 | [Source Data] Définissez la source de données dans laquelle la chaîne à extraire est stockée.

(Exemple)

##### Bloc

##### Texte

Var4 = substringFromLeft(Var3,Var1);

## Exemple d'opération

Variable dans [Source Data] | [Way to extract] | [Number of characters] | Variable dans [Destination Data] | Commentaires
Chaîne cible | Nombre maximum d'octets | Chaîne extraite à stocker
ABCDE | FromLeft | 3 | 5 | ABC | -
0 | 5 | (aucun) | Une chaîne n'est pas stockée car la valeur [Number of characters] est inférieure à 1. Cela est considéré comme un échec dans le 'Résultat de l'opération'.
3.6 | 5 | ABC | Les valeurs à droite de la virgule dans [Number of characters] sont abandonnées.
FromRight | 3 | 5 | CDE | -
-1 | 5 | (aucun) | Une chaîne n'est pas stockée car la valeur [Number of characters] est inférieure à 1. Cela est considéré comme un échec dans le 'Résultat de l'opération'.
3.7 | 5 | CDE | Les valeurs à droite de la virgule dans [Number of characters] sont abandonnées.
AB | FromLeft | 3 | 5 | (aucun) | Une chaîne n'est pas stockée car la valeur [Number of characters] dépasse le nombre de caractères récupérables. Cela est considéré comme un échec dans le 'Résultat de l'opération'.
FromRight | 3 | 5 | (aucun) | Une chaîne n'est pas stockée car la valeur [Number of characters] dépasse le nombre de caractères récupérables. Cela est considéré comme un échec dans le 'Résultat de l'opération'.
ABCD(0x00)C | FromRight | 3 | 5 | BCD | Si la valeur est NULLE (0x00), la chaîne se termine là.
AB(0x00)CD | FromLeft | 3 | 5 | (aucun) | Une chaîne n'est pas stockée. Si la valeur est NULLE (0x00), la chaîne se termine là. Par conséquent, [Number of characters] dépasse le nombre de caractères récupérables. Cela est considéré comme un échec dans le 'Résultat de l'opération'.
AB(0x00)CDEF | FromRight | 3 | 5 | (aucun) | Une chaîne n'est pas stockée. Si la valeur est NULLE (0x00), la chaîne se termine là. Par conséquent, [Number of characters] dépasse le nombre de caractères récupérables. Cela est considéré comme un échec dans le 'Résultat de l'opération'.
ABCDEFGH | FromLeft | 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'.
FromRight | 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'.
AあB | FromLeft | 3 | 5 | AあB | Une chaîne est stockée selon la valeur [Number of characters]. *1
FromRight | 2 | 5 | あB | Une chaîne est stockée selon la valeur [Number of characters]. *1

*1 Si le nombre maximum d'octets dans la variable [Destination Data] est inférieur à la taille de la chaîne récupérée, l'opération échouera. Le nombre maximum d'octets dépend du codage de la variable [Destination Data].