COPY_***_*** : Copie sur des tableaux
Traduction de la notice originale
A propos de nous
Description de la fonction
La fonction COPY_***_*** copie une série d'éléments contigus d'un tableau dans un autre. Les tableaux sont de types différents ou identiques et la zone cible est définie par des paramètres de la fonction.
Les paramètres supplémentaires EN et ENO peuvent être configurés.
AVERTISSEMENT
FONCTIONNEMENT IMPREVU DE L'APPLICATION
Vérifiez que les données en cours d'écriture dans le tableau cible sont valides lors de l'utilisation de la fonction COPY_***_***.
Le non-respect de ces instructions peut provoquer la mort, des blessures graves ou des dommages matériels.
NOTE : La fonction COPY_***_*** peut générer des valeurs de données inattendues. Par exemple, la copie de valeurs d'entrée sur des valeurs de sortie peut corrompre les données et provoquer un fonctionnement inattendu de l'application.
Fonctions disponibles
Les fonctions disponibles sont les suivantes :
Représentation en FBD
Représentation appliquée à l'affectation d'une zone d'un tableau d'entiers à une zone de tableau de bits :
Représentation en LD
Représentation appliquée à l'affectation d'une zone d'un tableau d'entiers à une zone de tableau de bits :
Représentation en IL
Représentation appliquée à l'affectation d'une zone d'un tableau d'entiers à une zone de tableau de bits : 
LD Array1
COPY_ARINT_AREBOOL Begin_Row, Element_Number, Destination_Row
ST Result_Array
Représentation en ST
Représentation appliquée à l'affectation d'une zone d'un tableau d'entiers à une zone de tableau de bits : 
Result_Array := COPY_ARINT_AREBOOL(Array1, Begin_Row, Element_Number, Destination_Row);
Description des paramètres
Le tableau suivant décrit les paramètres d’entrée :
Paramètre
Type
Commentaire
Array1
ARRAY [n…m] OF EBOOL,
ARRAY [n..m] OF INT,
ARRAY [n…m] OF DINT
n et m sont des entiers positifs, négatifs ou nuls.
Begin_Row
INT
Rang du premier élément à copier du tableau Array1.
Remarque : le rang du premier élément du tableau est 0.
Element_Number
INT
Nombre d'éléments à copier du tableau Array1.
Destination_Row
INT
Rang cible du tableau Result_Array.
Le tableau suivant décrit les paramètres de sortie :
Paramètre
Type
Commentaire
Result_Array
ARRAY [n..m] OF EBOOL,
ARRAY [n..m] OF INT,
ARRAY [n…m] OF DINT
n et m sont des entiers positifs, négatifs ou nuls.
Tableau cible qui contient les éléments sélectionnés dans Array1.
NOTE : Si le nombre d'éléments à extraire est supérieur à la taille restante, en commençant par le rang Begin_Row, la fonction extrait tous les éléments de Begin_Row jusqu'au dernier élément du tableau.
Si le nombre d'éléments à extraire est supérieur à l'espace disponible en commençant par le rang Destination_Row, la fonction de copie est exécutée jusqu'au dernier élément du tableau.
Une valeur négative de Begin_Row, Element_Number et Destination_Row est interprétée comme nulle.