• Le type Tableau.
• Les types Date, Heure et Durée.
• Les types File et Pile.
• Les types Enumération et Combinaison.
• Le type Structure.

	Durée estimée : 1 h

Déclaration

Remplissage d'un tableau et accès aux éléments

	Important	Les indices des éléments du tableau commencent à 1.

• Pour tester l'ajout d'éléments dans un tableau, nous allons tester un petit exemple de code :
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     // Création d'un tableau de chaînes
     MonTableau est un tableau de chaînes
      
     // Ajout d'éléments
     MonTableau.Ajoute("WINDEV")
     MonTableau.Ajoute("WEBDEV")
     MonTableau.Ajoute("WINDEV Mobile")
      
     // Affichage du contenu du troisième élément
     Trace("Valeur de l'élément 3 : [%MonTableau[3]%]")
     
  3. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  4. Affichez si nécessaire le volet "Trace du débogueur" pour voir le résultat : sous le volet "Accueil", dans le groupe "Environnement", déroulez "Volets" et sélectionnez "Trace du débogueur".
  5. Le volet "Trace du débogueur" contient les informations suivantes :
     
     Valeur de l'élément 3 : WINDEV Mobile

	Astuce	Initialisation rapide d'un tableau Pour initialiser un tableau, il est également possible d'utiliser la syntaxe suivante : // Déclare un tableau TableauJour est un tableau de chaînes // Initialisation avec // les noms des jours de la semaine TableauJour = ["Lundi", "Mardi", "Mercredi", "Jeudi", "Vendredi", "Samedi", "Dimanche"]

Parcours d'un tableau

• Une boucle classique de type POUR .. A.
• Une boucle de type POUR TOUT.

• Dans le cas d'une boucle classique de type POUR .. A .., il est nécessaire de donner la valeur de l'indice de départ (1) et de l'indice d'arrivée.
  1. Par exemple, ajoutez le code suivant dans l'événement "Initialisation" du projet :
     
     POUR Indice = 1 À MonTableau.Occurrence
     Trace("Valeur de l'élément [%Indice%] : [%MonTableau[Indice]%]")
     FIN
     
     
     Dans ce code, l'indice de départ est 1, l'indice d'arrivée est donné par la propriété Occurrence du tableau.
  2. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  3. Le volet "Trace du débogueur" contient les informations suivantes :
     
     Valeur de l'élément 1 : WINDEV
     Valeur de l'élément 2 : WEBDEV
     Valeur de l'élément 3 : WINDEV Mobile

• Le WLangage propose un type de boucle beaucoup plus simple et tout aussi performant : la boucle POUR TOUT. Nous l'avons déjà vue sur les chaînes. Ce type de boucle s'applique également sur les tableaux. Dans ce cas, pas besoin d'indiquer l'indice de départ ou d'arrivée.
  1. Par exemple, remplacez le code de la boucle POUR par le code suivant dans l'événement "Initialisation" du projet :
     
     POUR TOUT ELÉMENT UneChaîne, Indice DE MonTableau
     Trace("Valeur de l'élément [%Indice%] : [%UneChaîne%]")
     FIN
     
     Dans ce cas, il suffit d'indiquer le nom de la variable qui correspond à l'élément du tableau et celle qui correspond à l'indice.
  2. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  3. Le volet "Trace du débogueur" contient les informations suivantes :
     
     Valeur de l'élément 1 : WINDEV
     Valeur de l'élément 2 : WEBDEV
     Valeur de l'élément 3 : WINDEV Mobile

Le tableau associatif

• Vous voulez tester ? Rien de plus simple.
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     // Création d'un tableau associatif de dates
     MonTableau est un tableau associatif de Dates
      
     // Ajout d'éléments
     MonTableau["Marc"] = "19820201"
     MonTableau["Anne"] = "19840604"
      
     // Affichage du contenu de l'élément ayant pour clé "Marc"
     Trace("Valeur de l'élément ayant pour clé ""Marc"" : " + MonTableau["Marc"])
      
     // Parcours du tableau
     POUR TOUT ELÉMENT Valeur, Clé, Indice DE MonTableau
     Trace("Valeur de l'élément [%Indice%] qui a pour clé [%Clé%] : [%Valeur%]")
     FIN
     
  3. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  4. Le volet "Trace du débogueur" contient les informations suivantes :
     
     Valeur de l'élément ayant pour clé "Marc" : 19820201
     Valeur de l'élément 1 qui a pour clé Marc : 19820201
     Valeur de l'élément 2 qui a pour clé Anne : 19840604

Le type Date

• Pour tester la manipulation des dates, nous allons tester un petit exemple de code :
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     MaDate est une Date
     
     Cette ligne de code permet de déclarer une variable de type Date. Par défaut, la variable est initialisée avec la date du jour.
  3. Maintenant, voyons comment affecter une date. Saisissez le code suivant :
     MaDate = Hier()
     MaDate = "20210929"
     
     L'initialisation peut être effectuée :
     • via une fonction WLangage. Dans cet exemple, la fonction Hier est utilisée. Le WLangage propose de nombreuses fonctions permettant de connaître le premier ou dernier jour du mois, de l'année, ...
     • via une chaîne de caractères contenant la date au format "AAAAMMJJ".
  4. Les paramètres de la date peuvent également être modifiés à l'aide de propriétés WLangage. Saisissez le code suivant :
     
     // Modification des paramètres de la date
     MaDate.Année = 1985
     MaDate.Mois = 10
     MaDate.Jour = 26
     
  5. La fonction <Date>.VersChaîne permet de choisir le format d'affichage d'une date. Par exemple, saisissez le code suivant :
     
     Trace(MaDate.VersChaîne())
     Trace(MaDate.VersChaîne("Jjjj JJ Mmmm AAAA"))
     Trace(MaDate.VersJourEnLettre())
     
  6. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  7. Le volet "Trace du débogueur" contient :
     
     26/10/1985
     Samedi 26 Octobre 1985
     samedi
     • l'affichage en clair de la date.
     • l'affichage en clair de la date selon un masque.
     • la récupération du jour en lettres correspondant à la date.
  8. Il est également possible d'utiliser des opérateurs de comparaison entre des dates. Saisissez le code suivant :
     
     SI MaDate < DateDuJour() ALORS
     Trace("La date mémorisée est antérieure à la date du jour")
     FIN
     
  9. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  10. Le volet "Trace du débogueur" contient :
      
      26/10/1985
      Samedi 26 Octobre 1985
      samedi
      La date mémorisée est antérieure à la date du jour

Le type Heure

• De la même manière, il est possible de manipuler des heures grâce au type Heure.
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     // Déclaration d'une heure
     MonHeure est une Heure // Par défaut, l'heure est initialisée avec l'heure actuelle
      
     // Affectation d'une heure
     // - via une fonction WLangage
     MonHeure = Maintenant()
     // - fixée dans le code (par exemple 15h25)
     MonHeure = "1525"
      
     // Modification des paramètres de l'heure
     MonHeure.Heure = 12
     MonHeure.Minute = 0
     MonHeure.Seconde = 0
      
     // Affichage en clair de l'heure
     Trace(MonHeure.VersChaîne())
     // Affichage en clair de l'heure selon un masque
     Trace(MonHeure.VersChaîne("HH:mm:SS"))
      
     // Comparaison de 2 heures
     SI MonHeure < Maintenant() ALORS
     Trace("L'heure mémorisée est antérieure à l'heure actuelle")
     SINON
     Trace("L'heure mémorisée est postérieure à l'heure actuelle")
     FIN
     
     Ce code reprend toutes les possibilités que nous avons vu pour les dates, et les applique aux heures.
  3. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  4. Le volet "Trace du débogueur" affiche les différentes informations souhaitées.
     
     12:00:00:00
     12:00:00
     L'heure mémorisée est antérieure à l'heure actuelle
     • l'affichage en clair de l'heure.
     • l'affichage en clair de l'heure selon un masque.

Le type Durée

• Pour les durées, le même type de code peut être saisi.
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     // Déclaration d'une durée
     MaDurée est une Durée
      
     // Affectation d'une durée
     // - avec une valeur "en clair"
     MaDurée = 2 min 8 s
     // ou
     MaDurée = 128 s
     // - en fournissant la durée en secondes, en minutes, ...
     MaDurée.EnSecondes = 128
      
     // Affichage en clair de la durée
     Trace(MaDurée.VersChaîne("MM:SS"))
     
  3. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  4. Le volet "Trace du débogueur" affiche les différentes informations souhaitées.
     
     02:08

• Date,
• Heure,
• Durée.

Le type File

• Pour tester la manipulation des Files, nous allons tester un petit exemple de code :
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     MaFile est une File de chaînes
     
     Cette ligne de code permet de déclarer une variable de type File contenant des chaînes de caractères.
  3. Maintenant, voyons comment ajouter des données. Saisissez le code suivant :
     // Ajout de données
     // L'élément est ajouté à la fin de la file
     MaFile.Enfile("WINDEV")
     MaFile.Enfile("WEBDEV")
     MaFile.Enfile("WINDEV Mobile")
     
     La fonction <Variable File>.Enfile permet d'ajouter les données dans la file. Les éléments sont ajoutés à la fin de la file.
  4. Pour récupérer les données de la File, il suffit d'utiliser la fonction <Variable File>.Défile. Saisissez le code suivant :
     
     // Récupération de la valeur en début de file
     Donnée est une chaîne
     MaFile.Défile(Donnée)
     Trace(Donnée)
     
  5. Les propriétés peuvent également s'appliquer aux variables de type File. Par exemple, la propriété Occurrence permet de connaître le nombre d'éléments de la File.
     
     // Comptage
     Trace("La file comporte [%MaFile.Occurrence%] éléments")
     
  6. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  7. Le volet "Trace du débogueur" affiche le texte suivant :
     
     WINDEV
     La file comporte 2 éléments

Le type Pile

• Le même type de code peut être saisi pour tester la manipulation des Piles :
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     // Déclaration d'une pile
     MaPile est une Pile de chaînes
      
     // Ajout de données
     // L'élément est ajouté au sommet de la pile
     MaPile.Empile("WINDEV")
     MaPile.Empile("WEBDEV")
     MaPile.Empile("WINDEV Mobile")
      
     // Récupération de la valeur du sommet dans une variable
     Donnée est une chaîne
     MaPile.Dépile(Donnée)
     Trace(Donnée)
      
     // Comptage
     Trace("La pile comporte [%MaPile.Occurrence%] éléments")
     
     Pour les piles, l'élément est ajouté au sommet de la pile. Dans ce code, ce sont les fonctions <Variable Pile>.Empile et <Variable Pile>.Dépile qui sont utilisées pour manipuler les éléments.
  3. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  4. Le volet "Trace du débogueur" affiche le texte suivant :
     
     WINDEV Mobile
     La pile comporte 2 éléments

Les types Enumération et Combinaison

• Une variable de type Enumération peut être affectée uniquement avec une valeur de l'énumération.
• Une variable de type Combinaison peut être affectée avec une ou plusieurs valeurs de la combinaison.

• Pour tester la manipulation des Enumérations, nous allons tester un petit exemple de code :
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     // Déclaration de l'énumération
     Couleur est une Enumération
     Vert
     Bleu
     Rouge
     Jaune
     FIN
      
     // Déclaration d'une variable de type énumération
     CouleurTrait est un Couleur
      
     // Affectation d'une valeur
     CouleurTrait = Bleu
      
     // Comparaison de valeur
     SI CouleurTrait = Jaune ALORS
     Trace("Le trait est jaune")
     SINON
     Trace("Le trait n'est pas jaune")
     FIN
     
  3. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  4. Le volet "Trace du débogueur" affiche :
     
     Le trait n'est pas jaune

• Pour tester la manipulation des Combinaisons, nous allons tester un petit exemple de code :
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     // Déclaration de la combinaison
     Options est une Combinaison
     SiègeChauffant
     ToitOuvrant
     SellerieCuir
     BoiteAutomatique
     FIN
      
     // Déclaration d'une variable de type combinaison
     OptionsVéhicule est un Options
      
     // Affectation d'une valeur
     OptionsVéhicule = SiègeChauffant + SellerieCuir + BoiteAutomatique
      
     // Tester si une valeur est activée
     SI OptionsVéhicule[SiègeChauffant] = Vrai ALORS
     Trace("L'option siège chauffant est activée")
     FIN
     
  3. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  4. Le volet "Trace du débogueur" affiche :
     
     L'option siège chauffant est activée

Le type Structure

• Pour tester la manipulation des structures, nous allons tester un petit exemple de code :
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     NomComplet est une Structure
     Nom est une chaîne
     Prénom est une chaîne
     FIN
     
     Ce code permet de déclarer une structure composée de deux variables, Nom et Prénom. Les variables composant une structure sont appelées "Membre". Pour manipuler les membres, il faut déclarer une variable du type de la structure.
  3. Nous allons maintenant :
     • Déclarer une variable de type structure. Ajoutez le code WLangage suivant :
       
       Contact est un NomComplet
       
     • Affecter les membres de la structure. Ajoutez le code WLangage suivant :
       
       Contact.Nom = "POLO"
       Contact.Prénom = "MARCO"
       
  4. Pour lire le contenu d'un membre, il suffit d'utiliser la syntaxe :
     
     <Nom de la variable>.<Nom du membre>
     Dans notre exemple, saisissez le code suivant :
     
     LeNom est une chaîne
     LeNom = Contact.Nom
     Trace(LeNom)
     
  5. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  6. Le volet "Trace du débogueur" affiche :
     
     POLO

• Pour tester la manipulation des tableaux de structures, nous allons tester un petit exemple de code :
  1. Supprimez le code saisi dans l'événement "Initialisation" du projet (Ctrl + A pour tout sélectionner, et Suppr pour supprimer).
  2. Saisissez le code suivant :
     
     // Déclaration de la structure
     Adresse est une Structure
     NomSociété est une chaîne
     NomContact est une chaîne
     Adresse est une chaîne
     CodePostal est une chaîne
     Ville est une chaîne
     Pays est une chaîne
     FIN
      
     // Déclaration d'une variable de type structure
     UneAdresse est un Adresse
      
     // Remplissage d'une structure
     UneAdresse.NomSociété = "PC SOFT"
     UneAdresse.NomContact = "Paul Durant"
     UneAdresse.Adresse = "142 Avenue des Champs Élysées"
     UneAdresse.CodePostal = "75008"
     UneAdresse.Ville = "PARIS"
     UneAdresse.Pays = "FRANCE"
      
     // Déclaration d'un tableau de structures
     MesAdresses est un tableau de Adresse
     Ajoute(MesAdresses, UneAdresse)
     Trace(MesAdresses[1].NomSociété)
     
  3. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
  4. Le volet "Trace du débogueur" affiche :
     
     PC SOFT

• le type Chaîne,
• le type Tableau,
• les types Date, Heure et Durée,
• les types File et Pile,
• les types Enumération et Combinaison,
• le type Structure.