DESCRIPTION.

La procédure PROC_pcopy() affecte les éléments d'un tableau de données avec certaines lignes d'un autre tableau de données.

SYNTAXE.

PROC_pcopy( source , destination , place , debut , quantite )

REMARQUES.

source et destination doivent être des tableaux de données, déclarés et existant, à une seul dimension. 

place, debut et quantite doivent être des nombres entiers, où : 

- place est l'index du premier éléments qui sera affecté dans destination ;

- debut est l'index du premier éléments de source à transférer dans destination ;

- quantite est la quantité d'éléments de source à transférer dans destination.

source et destination peuvent avoir un nombre d'éléments différents, mais : 

- source doit avoir au moins debut + quantite éléments ;

- destination doit avoir au moins place + quantite éléments.

L'appel de la procédure PROC_pcopy() modifiera les valeurs des quantite éléments de destination à partir de l'index place avec les valeurs des quantite d'éléments depuis l'index debut de source.

L'appel de la procédure PROC_pcopy() ne modifie pas les valeurs des éléments de source ne des éléments de destination en dehors de la plage d'index de place à place + quantite. 

Si le type de données de source et de destination sont connues, en particulier si les éléments sont des chaines de caractères, on pourra ajouter le suffixe du type de valeur à l'appel de la procédure : 

- PROC_pcopy(), pour des valeurs numériques de type réel signé ;

- PROC_pcopy%(), pour des valeurs numériques de type entier signé 32 bits ;

- PROC_pcopy&(), pour des valeurs numériques de type octet 8 bits non signé ;

- PROC_pcopy#(), pour des valeurs numériques de type réel double de 64 bits ;

- PROC_pcopy$(), pour des valeurs de type chaine de caractères ;

- PROC_pcopy%%(), pour des valeurs numériques de type entier signé 64 bits.

Voir l'instruction DIM() pour plus de détails sur les tableaux de données.

La procédure PROC_pcopy est importée depuis le module arraylib.bbc. 

EXEMPLE.

REM --- Importation des modules ---

REM --- Module de la bibliothèque BBC BASIC ---

INSTALL @lib$ + "arraylib.bbc"

REM --- INITIALISATION GENERALE ---

DIM LST_Source( 9 ) : LST_Source() = 0 , 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9

DIM LST_Destination( 12 ) : LST_Destination() = 9 , 9 , 9 , 9 , 9 , 9 , 9 , 9 , 9 , 9 , 9 , 9 , 9

REM --- Transfère des valeurs ---

PROC_pcopy( LST_Source() , LST_Destination() , 4 , 2 , 5 )

REM --- Lecture et affichage des éléments ---

FOR kindex = 0 TO 12 : PRINT LST_Destination( kindex ) ; : NEXT kindex

REM --- Fin du programme ---

END