PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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 :
  • Cette fonction est équivalente à la fonction TableauInsère.
  • WEBDEV - Code NavigateurPHP Cette fonction est utilisable uniquement avec les variables de type Tableau et Tableau associatif.
Versions 16 et supérieures
Java Cette fonction est désormais disponible pour les applications Java.
PHP Cette fonction est désormais disponible pour les sites PHP.
Android Cette fonction est désormais disponible pour les applications Android.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Nouveauté 16
Java Cette fonction est désormais disponible pour les applications Java.
PHP Cette fonction est désormais disponible pour les sites PHP.
Android Cette fonction est désormais disponible pour les applications Android.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Java Cette fonction est désormais disponible pour les applications Java.
PHP Cette fonction est désormais disponible pour les sites PHP.
Android Cette fonction est désormais disponible pour les applications Android.
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.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
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.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
AndroidWidget AndroidJava Cette fonction est désormais disponible pour les variables de type Liste.
Nouveauté 21
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
AndroidWidget AndroidJava Cette fonction est désormais disponible pour les variables de type Liste.
Apple Watch Cette fonction est désormais disponible en mode Apple Watch.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
AndroidWidget AndroidJava Cette fonction est désormais disponible pour les variables de type Liste.
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é.
WEBDEV - Code NavigateurPHP Non disponible en code navigateur et en PHP

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 :
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

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 :
PremierElémentLa liste est insérée au début de la liste <Liste WLangage>.
DernierElémentLa liste est insérée en fin de liste <Liste WLangage>.
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.
<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.
WEBDEV - Code NavigateurAndroidWidget AndroidJavaPHP Cette fonctionnalité n'est pas disponible.
WEBDEV - Code NavigateurPHP Cette fonctionnalité n'est pas disponible.

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.
WEBDEV - Code NavigateurAndroidWidget AndroidJavaPHP Cette fonctionnalité n'est pas disponible.
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 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 : wd240vm.dll
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire