Tuto - Les bases du WLangage

Le type Date

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.

   MaDate = Hier()
   MaDate = "20210929"

   Ce code présente les différentes manières d'initialiser une variable de type Date. 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. Il est également possible d'utiliser la fonction <Date>.VersJourEnLettre. 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

   Dans ce code, la fonction DateDuJour permet comme son nom l'indique de connaître la date correspondant au jour.
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

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

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 = 2 min 8 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

Pour plus de détails sur les variables de type Date, Heure et Durée, consultez Variable de type Date, Variable de type Heure, Variable de type Durée.

Déclaration

MonTabChaîne est un tableau de chaînes
MonTabEntier est un tableau d'entiers

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

Pour accéder aux éléments d'un tableau, il suffit d'utiliser la syntaxe suivante :

<Nom du tableau> [<Indice de l'élément>]

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

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 "Volets" puis "Trace du débogueur".
5. Le volet "Trace du débogueur" contient les informations suivantes :
   
   Valeur de l'élément 3 : WINDEV Mobile

Parcours d'un tableau

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

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

1. Par exemple, remplacez le code de la boucle POUR par le code suivant dans l'événement "Initialisation" du projet :
   

   POUR TOUT Ã‰LÉ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

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 tableau associatif de Date
   
   // 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 Ã‰LÉ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

Pour plus de détails sur les variables de type Tableau associatif, consultez la page d'aide Tableau associatif.

Le type Structure

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
   // Affiche le contenu de la variable LeNom
   Trace(LeNom)
   // Affiche directement Contact.Nom (sans passer par une variable)
   Trace(Contact.Nom)

5. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
6. Le volet "Trace du débogueur" affiche :
   
   POLO
   POLO

1. A la suite du code déjà saisi, saisissez le code suivant :
   
   // Déclaration d'un tableau de structures
   MesContacts est un tableau de NomComplet
   Ajoute(MesContacts, Contact)
   Trace(MesContacts[1].Nom + " " + MesContacts[1].Prénom)
   
   Dans ce code, nous créons un tableau contenant la structure NomComplet, nous lui ajoutons le contact que nous avons créé précédemment puis nous affichons le nom et le prénom de ce contact.
2. Testons immédiatement ce code : cliquez sur parmi les boutons d'accès rapide.
3. Le volet "Trace du débogueur" affiche maintenant :
   
   POLO
   POLO
   POLO MARCO

Pour plus de détails sur les variables de type Structure et Tableau de structures, consultez Structure.

• les types Date, Heure et Durée,
• le type Tableau,
• le type Structure.