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

• 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").

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`

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

• 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.

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"

• 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
  ]
  ]

• 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.