PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Ajout d'un élément dans un tableau WLangage
  • Ajout d'un élément dans une propriété tableau d'un type avancé
  • Ajout d'un élément dans une liste
  • Ajout d'un tableau dans un tableau (concaténation)
  • Ajout d'une liste dans une liste (concaténation)
  • Ajouter le contenu d'une structure dans un tableau de structures sans passer par une variable de cette structure
  • 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
Ajoute un élément en dernière position :
  • d'un tableau WLangage à une dimension.
  • d'une propriété tableau d'un type avancé (tableau des événements de gglAgenda, tableau d'un document de type Traitement de texte, ...).
  • d'une liste WLangage.
Cette fonction permet également de concaténer deux tableaux ou deux listes.
Remarques :
  • Cette fonction est identique à la fonction TableauAjoute.
  • WEBDEV - Code NavigateurPHP Cette fonction est utilisable uniquement avec les variables de type Tableau.
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.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
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.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
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.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code navigateur.
AndroidWidget AndroidJava Cette fonction est désormais disponible pour les variables de type Liste.
Exemple
MonTableau est un tableau de 2 chaînes
Ajoute(MonTableau, "WINDEV")
Ajoute(MonTableau, " WEBDEV")
Ajoute(MonTableau, "WINDEV et WEBDEV")
// Afficher le contenu du 3° élément (les deux premiers sont vides)
Trace(MonTableau[3])  // Affiche "WINDEV"
MonTableau est un tableau de 2 chaînes
MonTableau[1] = "WINDEV"
MonTableau[2] = "WEBDEV"
Ajoute(MonTableau, "WINDEV et WEBDEV")
// Afficher le contenu du 3° élément
Trace(MonTableau[3]) // Affiche "WINDEV et WEBDEV"
WINDEVWEBDEV - Code ServeurLinuxAndroidiPhone/iPadJavaAjax
// Exemple d'ajout d'un élément dans un fichier XML
NoeudRSS est un xmlNoeud,description="NEWS.rss.channel.item"
NoeudRSS.title = DateVersChaîne(DateSys(), "JJ/MM/AAAA") + " - " + ...
HeureVersChaîne(HeureSys(), "HH:MM") + " : " + sTitre
NoeudRSS.description = sCommentaire
NoeudRSS.link = sLienHTTP
NoeudRSS.enclosure:type = "image/jpeg"
NoeudRSS.enclosure:length = 150
NoeudRSS.enclosure:url = sURL_Image
 
Ajoute(MonDocXML.rss.channel, NoeudRSS)
XMLSauve(MonDocXML, gsCheminFichierXML)
Syntaxe

Ajouter un élément à un tableau, à une propriété tableau d'un type avancé ou à une liste Masquer les détails

<Résultat> = Ajoute(<Variable WLangage> [, <Valeur>])
<Résultat> : Entier
Indice auquel l'élément spécifié a été ajouté. En cas d'erreur, une erreur fatale est affichée.
<Variable WLangage> : Tableau ou Liste
Nom de la variable à manipuler. Cette variable peut être :
  • Une variable de type Tableau.
  • Une variable de type Liste.
    WEBDEV - Code NavigateurAndroidWidget AndroidJavaPHP Ce type de variable n'est pas disponible. WEBDEV - Code NavigateurPHP Ce type de variable n'est pas disponible.
<Valeur> : Type des éléments du tableau, optionnel
Valeur à ajouter au tableau ou à la liste. Ce paramètre est obligatoire dans le cas d'une liste.
Dans le cas d'un tableau, 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.

Concaténer des tableaux ou des listes Masquer les détails

<Résultat> = Ajoute(<Variable WLangage> [, <Variable à concaténer>])
<Résultat> : Entier
Indice auquel l'élément spécifié a été ajouté. En cas d'erreur, une erreur fatale est affichée.
<Variable WLangage> : Tableau ou Liste
Nom de la variable à manipuler. Cette variable peut être :
  • Une variable de type Tableau.
  • Une variable de type Liste.
    WEBDEV - Code NavigateurPHP Ce type de variable n'est pas disponible.
<Variable à concaténer> : Tableau ou liste optionnel
Nom de la variable à ajouter à la suite des éléments déjà présents. Cette variable peut être :
  • Une variable de type Tableau, pour concaténer deux tableaux.
  • Une variable de type Liste, pour concaténer deux listes.
    WEBDEV - Code NavigateurAndroidWidget AndroidJavaPHP Ce type de variable n'est pas disponible. WEBDEV - Code NavigateurPHP Ce type de variable n'est pas disponible.
Remarques

Ajout d'un élément dans un tableau WLangage

Lors de l'utilisation de la fonction Ajoute :
  • 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.
Remarque : Lors de la déclaration d'un tableau de N par M é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'ajout d'un élément (fonction Ajoute), cet élément est automatiquement ajouté à la suite des éléments déjà présents dans le tableau.
Dans notre exemple, l'élément ajouté correspondra au 4° élément.

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

Lors de l'utilisation de la fonction Ajoute :
  • 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.

Ajout d'un élément dans une liste

Lors de l'utilisation de la fonction Ajoute :
  • 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.

Ajout d'un tableau dans un tableau (concaténation)

Lors de l'utilisation de la fonction Ajoute :
  • le tableau est automatiquement agrandi pour accueillir les nouveaux éléments. Les éléments du <Nom de la variable à concaténer> sont ajoutés à la fin de <Nom de la variable>.
  • les deux tableaux doivent être du même type.
  • la dimension des tableaux doit être identique.
  • les dimensions des tableaux (autres que la première dimension) doivent être identiques.
    Par exemple :
    Code correct :
    t1 est un tableau de * par 2 entiers = [[1,2],[3,4]]
    t2 est un tableau de * par 2 entiers = [[5,6],[7,8],[9,10]]
    Ajoute(t1, t2)
    Code incorrect :
    t1 est un tableau de * par 3 entiers = [[1,2],[3,4]]
    t2 est un tableau de * par 2 entiers = [[5,6],[7,8],[9,10]]
    Ajoute(t1, t2)

Ajout d'une liste dans une liste (concaténation)

Lors de l'utilisation de la fonction Ajoute :
  • la liste est automatiquement agrandie pour accueillir les nouveaux éléments. Les éléments du <Nom de la variable à concaténer> sont ajoutés à la fin de <Nom de la variable>.
  • 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.

Ajouter le contenu d'une structure dans un tableau de structures sans passer par une variable de cette structure

Si vous utilisez un tableau de structures avec peu de membres, il peut être plus simple d'ajouter directement une structure en utilisant l'opérateur [ ] (crochet). Par exemple, pour la structure suivante :
// Structure pour mémoriser une lettre et son code ASCII
STTouche est une Structure
sTouche est une chaîne
nCodeAscii est un entier
FIN
// Tableau de structures
tabTouches est un tableau de STTouche
L'ajout se fait généralement en passant par une variable du type de la structure :
// Structure temporaire pour l'ajout
stUneTouche est un STTouche
// Mémorise la lettre A
stUneTouche.sTouche = "A"
stUneTouche.nCodeAscii = Asc("A")
Ajoute(tabTouches, stUneTouche)
Avec l'opérateur [ ], vous pouvez gagner en visibilité :
// Mémorise la lettre A
Ajoute(tabTouches, ["A", Asc("A")])

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

Divers

  • Pour ajouter un élément à une position donnée, utilisez la fonction TableauInsère ou Insère.
  • 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