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
  • Ajout 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 à 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.
WEBDEV - Code NavigateurPHP Remarque : Cette fonction est utilisable uniquement avec les variables de type Tableau et Tableau associatif.
Exemple
MonTableau est un tableau de 2 chaînes
MonTableau.Insère(1, "WINDEV")
MonTableau.Insère(2, "WEBDEV")
MonTableau.Insère(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"
MonTableau.Insère(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 tableau associatif de chaînes
taNomPrenom.Insère("Moulin", "Françoise")
taNomPrenom.Insère("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

<Tableau WLangage>.Insère(<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 <Tableau>.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 spécifié, à 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

<Tableau WLangage>.Insère(<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 à ajouter au tableau spécifié.

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

<Tableau WLangage>.Insère(<Indice d'insertion> [, <Tableau à 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 <Tableau>.Ajoute).
Si <Indice d'insertion> est supérieur au nombre d'éléments du tableau +1, une erreur WLangage est générée.
<Tableau à insérer> : Tableau optionnel
Nom de la variable Tableau à insérer à l'indice d'insertion spécifié dans <Tableau WLangage>.
WEBDEV - Code NavigateurPHP Non disponible en code navigateur et en PHP

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

<Liste WLangage>.Insère(<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.
WEBDEV - Code NavigateurPHP Non disponible en code navigateur et en PHP

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

<Liste WLangage>.Insère(<Indice d'insertion> , <Liste à 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 <Nom de la liste>.
PremierElémentLa liste est insérée au début de la liste <Nom de la liste>.

<Liste à insérer> : Liste
Nom de la 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 <Tableau>.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 <Tableau>.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.

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

Lors de l'utilisation de la fonction <Tableau>.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 <Tableau>.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.
WEBDEV - Code NavigateurPHP Cette fonctionnalité n'est pas disponible.

Insertion d'un tableau

Lors de l'utilisation de la fonction <Tableau>.Insère :
  • le tableau est automatiquement agrandi pour accueillir les nouveaux éléments. Les éléments du <Nom du tableau à 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 <Tableau>.Insère :
  • la liste est automatiquement agrandie pour accueillir les nouveaux éléments. Les éléments du <Nom de la liste à insérer> sont ajoutés à la position spécifiée.
  • les deux listes doivent être du même type.
WEBDEV - Code NavigateurPHP Cette fonctionnalité n'est pas disponible.

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 <Tableau>.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 <Tableau>.Ajoute.
  • Pour ajouter un élément dans un tableau trié (en respectant le tri), utilisez la fonction <Tableau>.AjouteTrié.
Composante : wd300vm.dll
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/06/2023

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