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
  • Ajout d'une ligne dans un tableau WLangage
  • Ajout d'une ligne dans une propriété tableau d'un type avancé
  • 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
Ajoute une ligne à la fin :
  • d'un tableau WLangage à une ou deux dimensions.
  • d'une propriété tableau d'un type avancé à deux dimensions (xlsDocument, ...).
Exemple
MonTableau est un tableau de 2 par 3 chaînes
MonTableau.AjouteLigne("A", "B", "C")
MonTableau.AjouteLigne("a", "b", "c")
MonTableau.AjouteLigne("D", "E", "F")
// Afficher le contenu de la 3° ligne (les deux premières sont vides)
Trace(MonTableau[3,1], MonTableau[3,2], MonTableau[3,3])
// Affiche "A B C"
MonTableau est un tableau de 2 par 3 chaînes
MonTableau[1,1] = "A"
MonTableau[1,2] = "B"
MonTableau[1,3] = "C"
MonTableau[2,1] = "a"
MonTableau[2,2] = "b"
MonTableau[2,3] = "c"
MonTableau.AjouteLigne("D", "E", "F")
// Afficher le contenu de la 3° ligne
Trace(MonTableau[3,1], MonTableau[3,2], MonTableau[3,3])
// Affiche "D E F"
Syntaxe
<Résultat> = <Tableau WLangage>.AjouteLigne([<Élément colonne 1> [... [, <Élément colonne N>]]])
<Résultat> : Entier
  • Indice de la ligne ajoutée,
  • -1 en cas d'erreur.
<Tableau WLangage> : Tableau
Nom de la variable de type Tableau à manipuler. Ce tableau doit être un tableau à une ou deux dimensions.
<Élément colonne 1> : Type des éléments du tableau, optionnel
Élément de la ligne à ajouter dans le tableau spécifié. Chaque élément correspond à une colonne dans le tableau. Le type de l'élément ajouté doit être compatible avec le type de la colonne concernée.
Si aucun de ces paramètres n'est spécifié, une ligne vide est ajoutée dans le tableau. Les colonnes sont initialisées avec la valeur par défaut du type des autres éléments du tableau.
Si un de ces paramètres n'est pas spécifié, la colonne correspondante est initialisée avec la valeur par défaut du type des autres éléments du tableau.
<Élément colonne N> : Type des éléments du tableau, optionnel
Élément de la ligne à ajouter dans le tableau spécifié. Chaque élément correspond à une colonne dans le tableau. Le type de l'élément ajouté doit être compatible avec le type de la colonne concernée.
Si aucun de ces paramètres n'est spécifié, une ligne vide est ajoutée dans le tableau. Les colonnes sont initialisées avec la valeur par défaut du type des autres éléments du tableau.
Si un de ces paramètres n'est pas spécifié, la colonne correspondante est initialisée avec la valeur par défaut du type des autres éléments du tableau.
Remarques

Ajout d'une ligne dans un tableau WLangage

Lors de l'utilisation de la fonction <Tableau>.AjouteLigne :
  • le nombre de lignes du tableau est automatiquement agrandi pour accueillir la nouvelle ligne.
  • le nombre de colonnes du tableau n'est pas agrandi. Il est donc nécessaire :
    • soit de déclarer le tableau avec le bon nombre de colonnes (deuxième dimension du tableau).
    • soit de modifier dynamiquement le nombre de colonnes avec la fonction Dimension.
  • les éléments sont convertis si nécessaire dans le type des autres éléments du tableau.
Remarque : Lors de la déclaration d'un tableau de N par M éléments, ce tableau contient N lignes vides. Par exemple, le tableau déclaré ci-dessous contient 3 lignes vides.
MonTableau est un tableau de 3 par 2 chaînes
Lors de l'ajout d'une ligne (fonction <Tableau>.AjouteLigne), cette ligne est automatiquement ajoutée à la suite des lignes déjà présentes dans le tableau.
Dans notre exemple, la ligne ajoutée correspondra à la 4° ligne.

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

Lors de l'utilisation de la fonction <Tableau>.AjouteLigne :
  • 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 la nouvelle ligne.

Divers

  • Cette fonction ne peut pas être utilisée sur :
    • les tableaux non alloués.
    • les tableaux fixes.
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