DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des files, piles, listes et tableaux / Fonctions Tableau
  • Insertion d'un élément dans un tableau
  • Insertion d'un élément dans une propriété tableau d'un type avancé
  • Insertion d'un élément dans une liste
  • Insertion d'un tableau
  • Insertion d'une liste
  • Conditions d'utilisation
  • Divers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Insère un élément à une position donnée :
  • dans un tableau WLangage à une dimension.
  • dans un tableau associatif.
  • dans une propriété tableau d'un type avancé (tableau des événements de gglAgenda, ...).
  • dans une liste WLangage.
Cette fonction permet également de concaténer deux tableaux ou deux listes.
Remarques :
Exemple
MonTableau est un tableau de 2 chaînes
Insère(MonTableau, 1, "WINDEV")
Insère(MonTableau, 2, "WEBDEV")
Insère(MonTableau, 3, "WINDEV et WEBDEV")
// Afficher le contenu du 3° élément
Trace(MonTableau[3]) // Affiche "WINDEV et WEBDEV"
MonTableau est un tableau de 2 chaînes
MonTableau[1] = "WINDEV"
MonTableau[2] = "WEBDEV"
Insère(MonTableau, 3, "WINDEV et WEBDEV")
// Afficher le contenu du 3° élément
Trace(MonTableau[3]) // Affiche "WINDEV et WEBDEV"
// Tableau associatif NOM - Prénom
taNomPrenom est un tableau associatif de chaînes
Insère(taNomPrenom, "Moulin", "Françoise")
Insère(taNomPrenom, "Montgomery", "Julie")
Syntaxe

Insérer un élément dans un tableau ou dans une propriété tableau d'un type avancé Masquer les détails

Insère(<Tableau WLangage> , <Indice d'insertion> [, <Valeur de l'élément>])
<Tableau WLangage> : Tableau
Nom de la variable de type Tableau à manipuler. Ce tableau doit être un tableau à une dimension.
<Indice d'insertion> : Entier
Indice du tableau où l'élément doit être inséré. Tous les éléments à partir de cet indice seront décalés de 1 élément.
Si <Indice d'insertion> est égal au nombre d'éléments du tableau +1, l'élément est ajouté à la fin du tableau (équivalent à la fonction TableauAjoute ou à la fonction Ajoute).
Si <Indice d'insertion> est supérieur au nombre d'éléments du tableau +1, une erreur WLangage est générée.
<Valeur de l'élément> : Tout type, optionnel
Elément à insérer dans le tableau à la position indiquée. Si ce paramètre n'est pas spécifié, le tableau est agrandi avec la valeur par défaut du type des autres éléments du tableau.

Insérer un élément dans un tableau associatif Masquer les détails

Insère(<Tableau WLangage> , <Clé de l'élément> , <Valeur de l'élément>)
<Tableau WLangage> : Tableau
Nom de la variable de type Tableau à manipuler. Ce tableau doit être un tableau à une dimension.
<Clé de l'élément> : Type de la clé du tableau associatif
Valeur de la clé pour laquelle l'élément doit être inséré. Dans un tableau associatif sans doublons, si l'élément existe déjà, une erreur WLangage est affichée.
<Valeur de l'élément> : Tout type
Elément à insérer au tableau spécifié.

Insérer un tableau dans un tableau Masquer les détails

Insère(<Tableau WLangage> , <Indice d'insertion> [, <Tableau WLangage à insérer>])
<Tableau WLangage> : Tableau
Nom de la variable de type Tableau à manipuler. Ce tableau doit être un tableau à une dimension.
<Indice d'insertion> : Entier
Indice du tableau où l'élément doit être inséré. Tous les éléments à partir de cet indice seront décalés de 1 élément.
Si <Indice d'insertion> est égal au nombre d'éléments du tableau +1, l'élément est ajouté à la fin du tableau (équivalent à la fonction TableauAjoute).
Si <Indice d'insertion> est supérieur au nombre d'éléments du tableau +1, une erreur WLangage est générée.
<Tableau WLangage à insérer> : Tableau optionnel
Tableau à insérer dans <Nom du tableau>. Cette insertion sera réalisée à l'indice d'insertion spécifié.

Insérer un élément dans une liste Masquer les détails

Insère(<Liste WLangage> , <Indice d'insertion> , <Valeur de l'élément>)
<Liste WLangage> : Liste
Nom de la variable de type Liste à manipuler.
<Indice d'insertion> : Constante de type entier
Indice de la liste où l'élément doit être inséré. Les constantes suivantes peuvent être utilisées :
AprèsElémentCourantL'élément est inséré après l'élément courant.
Cette constante est disponible uniquement lors du parcours des éléments de la liste.
Attention : L'élément sera parcouru par l'itération suivante si la boucle est ascendante.
AvantElémentCourantL'élément est inséré avant l'élément courant.
Cette constante est disponible uniquement lors du parcours des éléments de la liste.
Attention : L'élément sera parcouru par l'itération suivante si la boucle est descendante.
DernierElémentL'élément est inséré en fin de liste.
PremierElémentL'élément est inséré au début de la liste.
<Valeur de l'élément> : Tout type
Elément à insérer dans la liste à la position indiquée.

Insérer une liste dans une liste Masquer les détails

Insère(<Liste WLangage> , <Indice d'insertion> , <Liste WLangage à insérer>)
<Liste WLangage> : Liste
Nom de la variable de type Liste à manipuler.
<Indice d'insertion> : Constante de type entier
Indice de la liste où la liste doit être insérée. Les constantes suivantes peuvent être utilisées :
AprèsElémentCourantLa liste est insérée après l'élément courant.
Cette constante est disponible uniquement lors du parcours des éléments de la liste.
AvantElémentCourantLa liste est insérée avant l'élément courant.
Cette constante est disponible uniquement lors du parcours des éléments de la liste.
DernierElémentLa liste est insérée en fin de liste <Liste WLangage>.
PremierElémentLa liste est insérée au début de la liste <Liste WLangage>.
<Liste WLangage à insérer> : Liste
Liste à insérer à l'indice d'insertion spécifié.
Remarques

Insertion d'un élément dans un tableau

Lors de l'utilisation de la fonction Insère :
  • le tableau est automatiquement agrandi pour accueillir le nouvel élément.
  • l'élément est converti si nécessaire dans le type des autres éléments du tableau.
Lors de la déclaration d'un tableau de N éléments, ce tableau contient N éléments vides. Par exemple, le tableau déclaré ci-dessous contient 3 chaînes vides.
MonTableau est un tableau de 3 chaînes
Lors de l'insertion d'un élément (fonction Insère), cet élément est automatiquement inséré parmi les éléments déjà présents dans le tableau.
Dans notre exemple, après l'insertion d'un élément, le tableau contiendra 4 éléments.

Insertion d'un élément dans une propriété tableau d'un type avancé

Lors de l'utilisation de la fonction Insère :
  • la variable de type avancé doit être allouée.
  • le type avancé doit avoir un énumérateur de type collection modifiable.
  • le type avancé est automatiquement agrandi pour accueillir les nouveaux éléments.
  • l'élément est initialisé avec la valeur passée en paramètre. Si aucune valeur n'est passée en paramètre, l'élément est initialisé avec la valeur par défaut du type des éléments du tableau.

Insertion d'un élément dans une liste

Lors de l'utilisation de la fonction Insère :
  • la liste est automatiquement agrandie pour accueillir le nouvel élément.
  • l'élément est converti si nécessaire dans le type des autres éléments de la liste.

Insertion d'un tableau

Lors de l'utilisation de la fonction Insère :
  • le tableau est automatiquement agrandi pour accueillir les nouveaux éléments. Les éléments du <Tableau WLangage à insérer> sont ajoutés à la position spécifiée dans <Nom du tableau>.
  • les deux tableaux doivent être du même type.
  • la dimension des tableaux doit être identique.
  • les valeurs des dimensions des tableaux (à l'exception de la première) doivent être identiques.

Insertion d'une liste

Lors de l'utilisation de la fonction Insère :
  • la liste est automatiquement agrandie pour accueillir les nouveaux éléments. Les éléments du <Liste WLangage à insérer> sont ajoutés à la position spécifiée.
  • les deux listes doivent être du même type.

Conditions d'utilisation

Cette fonction peut être utilisée avec des structures. Dans ce cas, il faut :
  1. Déclarer une variable du type de la structure.
  2. Initialiser chaque membre.
  3. Passer la variable structure en paramètre à la fonction Insère.
Cette fonction ne peut pas être utilisée sur :
  • les tableaux non alloués,
  • les tableaux fixes.

Divers

  • Pour ajouter un élément à la fin d'un tableau à une dimension, utilisez la fonction TableauAjoute ou la fonction Ajoute.
  • Pour ajouter un élément dans un tableau trié (en respectant le tri), utilisez la fonction TableauAjouteTrié.
Composante : wd290vm.dll
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale