DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Syntaxe WLangage / Types du WLangage
  • Chaîne littérale monoligne
  • Déclaration d'une chaîne littérale monoligne
  • Exemples
  • Chaîne littérale multiligne
  • Déclaration d'une chaîne littérale multiligne
  • Exemples
  • Avantages des syntaxes 1, 2 et 3
  • Limites
  • Interpolation de chaînes (ou construction dynamique des chaînes)
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
Chaînes littérales : chaînes de caractères monolignes et multilignes
Les chaînes littérales permettent de représenter et de manipuler des données textuelles. Les chaînes littérales permettent par exemple d'afficher une information, de définir une constante, etc.
WINDEV, WINDEV Mobile et WEBDEV mettent plusieurs outils à votre disposition pour saisir des chaînes de caractères, et notamment des chaînes de caractères sur plusieurs lignes. Il est également possible de réaliser des constructions dynamiques de chaînes.
Chaîne littérale monoligne

Déclaration d'une chaîne littérale monoligne

Une chaîne littérale est déclarée :
  • en plaçant les caractères de la chaîne entre guillemets.
  • en plaçant les caractères entre ` (caractère AltGr 7, appelé "backtick" ou "backquote" ou encore "Accent grâve").

Chaîne littérale monoligne avec guillemets Masquer les détails

<Nom variable> = "<Contenu de la chaîne>"
<"> :
Symbole signalant le début de la chaîne littérale monoligne.
<Contenu de la chaîne> :
Chaîne littérale monoligne.
Pour utiliser le caractère " (guillemet) dans la chaîne, il est nécessaire de le doubler.
Attention : L'utilisation des [% %] dépend des options du projet. Pour plus de détails, consultez Interpolation de chaînes (ou construction dynamique des chaînes).
<"> :
Symbole signalant la fin de la chaîne littérale monoligne.

Chaîne littérale monoligne utilisant le ` (caractère AltGr 7) Masquer les détails

<Nom variable> = `<Contenu de la chaîne>`
<`> :
Symbole signalant le début de la chaîne littérale monoligne (caractère AltGr 7).
<Contenu de la chaîne> :
Chaîne littérale monoligne.
Pour utiliser le caractère ` (caractère AltGr 7) dans le texte de la chaîne, il est nécessaire de le doubler.
Attention : Les caractères [% %] permettent d'afficher le contenu de la variable présente entre ces caractères. Pour plus de détails, consultez Interpolation de chaînes (ou construction dynamique des chaînes).
<`> :
Symbole signalant la fin de la chaîne littérale monoligne (caractère AltGr 7).

Exemples

// Chaîne littérale monoligne avec guillemets
MaChaîneMonoligne est une chaîne
MaChaîneMonoligne = "Exemple de ligne de texte"

// Cas des guillemets doublés
MaChaîneMonoligne2 est une chaîne
MaChaîneMonoligne2 = "L'option ""Conditions générales"" doit être cochée"
// Affiche : L'option "Conditions générales" doit être cochée
// Chaîne littérale monoligne utilisant le ` (caractère AltGr 7)
MaChaîneMonoligne est une chaîne
MaChaîneMonoligne = `Exemple de ligne de texte`
Chaîne littérale multiligne

Déclaration d'une chaîne littérale multiligne

Une chaîne littérale multiligne peut être constituée de plusieurs lignes. Différentes syntaxes permettent de gérer ce type de chaînes :
  • les symboles [ et ].
  • les guillemets.
  • les symboles ` et ` (caractères AltGr 7).
  • le caractère "RC" (Retour Chariot) entre les différentes lignes de la chaîne multiligne.

Chaîne littérale multiligne utilisant les symboles [ ] Masquer les détails

<Nom variable> = [
                <Contenu de la chaîne>
                <Contenu de la chaîne 2>
                ]
<[> :
Symbole signalant le début de la chaîne multiligne. Ce symbole doit être suivi d'un retour chariot. Ce retour chariot n'est pas pris en compte dans la chaîne.
<Contenu de la chaîne> :
Chaîne multiligne, saisie sur plusieurs lignes, sans guillemets. Les retours chariots présents entre 2 lignes de la chaîne sont interprétés comme un passage à la ligne suivante. Les tabulations en début de ligne ne sont pas prises en compte. Les tabulations sur la ligne de fermeture sont autorisées.
Attention : L'utilisation des [% %] dépend des options du projet. Pour plus de détails, consultez Interpolation de chaînes (ou construction dynamique des chaînes).
<]> :
Symbole signalant la fin de la chaîne multiligne. Ce symbole doit être précédé d'un retour chariot. Ce retour chariot n'est pas pris en compte dans la chaîne.

Chaîne littérale multiligne utilisant les guillemets Masquer les détails

<Nom variable> = "
                <Contenu de la chaîne>
                <Contenu de la chaîne 2>
                "
<"> :
Symbole signalant le début de la chaîne multiligne. Ce symbole doit être suivi d'un retour chariot. Ce retour chariot n'est pas pris en compte dans la chaîne.
<Contenu de la chaîne> :
Chaîne multiligne, saisie sur plusieurs lignes, sans guillemets. Les retours chariots présents entre 2 lignes de la chaîne sont interprétés comme un passage à la ligne suivante. Les tabulations en début de ligne sont prises en compte.
Attention : L'utilisation des [% %] dépend des options du projet. Pour plus de détails, consultez Interpolation de chaînes (ou construction dynamique des chaînes).
<"> :
Symbole signalant la fin de la chaîne multiligne. Ce symbole doit être précédé d'un retour chariot. Ce retour chariot n'est pas pris en compte dans la chaîne.

Chaîne littérale multiligne utilisant les symboles ` et ` (caractères AltGr 7) Masquer les détails

<Nom variable> = `
                <Contenu de la chaîne>
                <Contenu de la chaîne 2>
                `
<`> :
Symbole signalant le début de la chaîne multiligne. Ce symbole doit être suivi d'un retour chariot. Ce retour chariot n'est pas pris en compte dans la chaîne.
<Contenu de la chaîne> :
Chaîne multiligne, saisie sur plusieurs lignes, avec ou sans guillemets. Les retours chariots présents entre 2 lignes de la chaîne sont interprétés comme un passage à la ligne suivante. Les tabulations en début de ligne sont prises en compte.
Avantage : Les caractères [% %] permettent automatiquement d'afficher le contenu de la variable présente entre ces caractères. Pour plus de détails, consultez Interpolation de chaînes (ou construction dynamique des chaînes).
<`> :
Symbole signalant la fin de la chaîne multiligne. Ce symbole doit être précédé d'un retour chariot. Ce retour chariot n'est pas pris en compte dans la chaîne.

Chaîne littérale multiligne utilisant le Retour Chariot Masquer les détails

<Nom variable> = "<Contenu de la chaîne>"+ RC + ...
                       "<Contenu de la chaîne 2>"
<Contenu de la chaîne> :
Chaîne multiligne, saisie sur plusieurs lignes, avec guillemets pour chaque ligne. Chaque ligne est séparée par "+ RC + ...".

Exemples

// Utilisation des crochets pour saisir une chaîne de caractères multiligne
MaChaîne est une chaîne
MaChaîne = [
	Exemple de 
	chaîne multiligne
	]
MaChaîne est une chaîne
MaChaîne = [
	Exemple de 
	chaîne multiligne
	]
// Utilisation du Retour Chariot pour saisir une chaîne de caractères multiligne
MaChaîne est une chaîne
MaChaîne = "Exemple de " + RC + "chaîne multiligne"

Avantages des syntaxes 1, 2 et 3

  • Coloration de la chaîne : par défaut, la chaîne de caractères multiligne est colorée en violet (comme toute chaîne de caractères entre guillemets du WLangage) et surlignée en mauve.
    Il est possible d'utiliser les couleurs par défaut du WLangage pour la chaîne multiligne (option "Coloration de la chaîne .. WLangage" du menu contextuel de la chaîne multiligne). Cette option permet par exemple de vérifier le code saisi lorsqu'une chaîne multiligne est utilisée pour la compilation dynamique (fonction Compile).
  • Possibilité d'enrouler / dérouler une chaîne multiligne
    Enrouler les chaînes multilignes permet de libérer de l'espace dans l'éditeur de code. Le code devient plus clair et plus lisible. Lorsque la chaîne est enroulée, son contenu est affiché dans une bulle d'aide.
  • Avantage supplémentaire lors de l'utilisation de la syntaxe 2
    L'utilisation des guillemets est plus intuitive pour utiliser une chaîne de caractères (qu'elle soit monoligne ou multiligne).

Limites

  • Le nombre de lignes maximal d'une chaîne multiligne est 1000.
  • Il n'est pas possible d'utiliser des chaînes multilignes dans des chaînes multilignes. Le code suivant génère une erreur WLangage :
    sCode est une chaîne = [
    sChaîneMultilignes est une chaîne = [
    Test sur les chaînes multilignes
    Essai sur les chaînes multilignes
    ]
    ]
Interpolation de chaînes (ou construction dynamique des chaînes)
L'interpolation de chaînes consiste à combiner des variables (ou des expressions) et des chaînes de caractères. Pour effectuer cette opération, le WLangage propose différentes méthodes :
  • Méthode 1 : Interrompre la chaîne littérale pour prendre en compte la variable.
    Exemples :
    sCode est une chaîne = "La chaîne " + sVar + " est une chaîne"

    s est une chaîne = [
    	la chaîne
    	] + var + [
    	est multiligne
    	]

    s est une chaîne = "
    	la chaîne
    	" + var + "
    	est multiligne
    	"

    Cette solution est déconseillée notamment si la chaîne de caractères doit être traduite.
  • Méthode 2 : Utiliser la fonction ChaîneConstruit. Les valeurs paramétrables doivent être remplacées dans la chaîne littérale par les caractères %1, %2, %n.
    Exemples :
    sCode est une chaîne = "La chaîne %1 est une chaîne"
    sCode = ChaîneConstruit(sCode, MaVariable)

    sChaîne est une chaîne = [
    	la chaîne %1
    	est multiligne
    	]
    sChaîne = ChaîneConstruit(sChaîne, MaVariable)

    sChaîne est une chaîne = "
    	la chaîne %1
    	est multiligne
    	"
    sChaîne = ChaîneConstruit(sChaîne, MaVariable)
  • Méthode 3 : Utiliser l'option "Autoriser "[% %]" dans les chaînes".
    • Dans la fenêtre de description du projet, dans l'onglet "Compilation", cochez l'option Autoriser "[% %]" dans les chaînes.
    • Utilisez la syntaxe suivante pour indiquer l'expression à utiliser :
      [%Nomdevariable ou Expression%]
      Par exemple :
      // Demande de confirmation du client
      SI OuiNon(Oui, "Confirmez-vous la création du client [%sNomClient%]") = Non ALORS
      	RETOUR
      FIN
    Remarques :
    • Si vous utilisez les chaînes littérales multilignes construites avec les symboles ` et ` (caractères AltGr 7), les expressions utilisant "[% %]" sont automatiquement interprétées. Pas besoin de cocher l'option correspondante dans l'onglet "Compilation".
    • Si l'option n'est pas cochée dans l'onglet "Compilation" de la fenêtre de description du projet, la chaîne apparaît telle quelle : le nom de la variable (ou l'expression) apparaît dans la chaîne de caractères.
    • Pour ne pas interpréter les caractères "[% %]", il est nécessaire de les faire précéder par "-%". Certaines fonctions WLangage nécessitent cette syntaxe spécifique. Exemple :
      grBulle(GR_Echéance, grFormatBulle, "[%CATEGORIE%]" + RC + RC+ "[%VALEUR%]" + " H")
      devient
      grBulle(GR_Echéance, grFormatBulle, -%"[%CATEGORIE%]" + RC + RC + -%"[%VALEUR%]" + " H")
    • Lors de la traduction de ce type de chaînes, il est nécessaire de ne pas traduire le nom de la variable (ou l'expression) à l'intérieur des [% %]. Cependant, il est possible de modifier la place de la balise [%Nomdevariable ou Expression%] dans la phrase.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 26/03/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale