DESCRIPTION.

L'instruction SWAP échange les valeurs de 2 variables de types compatibles.

Voir l'instruction RECTANGLE SWAP ... TO pour échanger le contenu de deux zones rectangulaires.

SYNTAXE.

SWAP kvaleura , kvaleurb

SWAP kvaleura$ , kvaleurb$

SWAP LST_Tableaua() , LST_Tableaub()

SWAP DCT_Donneesa{} , DCT_Donneesb{}

REMARQUES.

L'instruction SWAP échange le contenu de deux variables, de deux tableaux ou de deux structures. Si les 2 variables ne sont pas de même type, une erreur de type sera retournée.

Si deux tableaux de données sont permutés, leurs dimensions le sont également.

Si deux structures de données sont permutées, leurs formats (nombre et type de membres) le sont également.

Note : les variables échangées, en particuliers les tableaux de données et les structures de données, doivent être de la même portée, globale ou locale, sinon cela entraînerait le pointage de la variable de portée globale vers la pile des variables de portée locale, qui deviendra invalide une fois la fonction ou la procédure quittée. Cela pourra retourner des erreurs, stoppant le programme en cours d'exécution.

Normalement, les éléments d'un même tableau de données, ou d'une même structure de données, peuvent échanger leur valeur avec l'instruction SWAP. Mais, il n'est pas possible d'utiliser l'instruction SWAP pour échanger :

- entièrement les éléments d'un tableau de données avec un autre ;

- entièrement les éléments d'une structure de données avec une autre :

- la valeur d'un élément d'un tableau de données avec un élément d'un autre tableau de données ;

- la valeur d'un élément d'une structure de données avec un élément d'une autre structure de données.

Le mot clé SWAP est également utilisé dans l'instruction RECTANGLE SWAP.

RUBRIQUE.

Les types de variables pour plus de détails sur la création et l'utilisation des variables.

EXEMPLES.

kminutes = 2

ksecondes = 34

PRINT kminutes , ksecondes : REM retourne 2 34

SWAP kminutes , ksecondes

PRINT kminutes , ksecondes : REM retourne 34 2

knom$ = "Jean"

kprenon$ = "Martin"

PRINT kprenon$ , knom$ : REM retourne Martin Jean 

SWAP kprenon$ , knom$

PRINT kprenon$ , knom$ : REM retourne Jean Martin