PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
Remarques :
  • Cette fonction est équivalente à la fonction Insère.
  • WEBDEV - Code NavigateurPHP Cette fonction est utilisable uniquement avec les variables de type Tableau et Tableau associatif.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 16 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Nouveauté 16
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
MonTableau est un tableau de 2 chaînes
TableauInsère(MonTableau, 1, "WINDEV")
TableauInsère(MonTableau, 2, "WEBDEV")
TableauInsè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"
TableauInsè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
TableauInsère(taNomPrenom, "Moulin", "Françoise")
TableauInsè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

TableauInsè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).
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

TableauInsè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 à ajouter au tableau spécifié.

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

TableauInsère(<Tableau WLangage> , <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 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 à 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

TableauInsè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 :
PremierElémentL'élément est inséré au début de la liste.
DernierElémentL'élément est inséré en fin de liste.
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.
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.
<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

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

<Nom de la liste à 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 TableauInsè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 TableauInsè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 TableauInsè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 TableauInsè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 TableauInsè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 TableauInsè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 TableauInsè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 : wd240vm.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire