|
|
|
|
|
|
|
|
- Utilisation de variables dans une chaîne multiligne
- Avantages des chaînes multilignes utilisant les symboles [ et ] ou les guillemets
- Limites
Chaînes multilignes En anglais : Multiline string
WINDEV, WINDEV Mobile et WEBDEV mettent plusieurs outils à votre disposition pour saisir des chaînes de caractères sur plusieurs lignes : - les symboles [ et ].
- les guillemets.
- les triples points (...).
// 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 des triples points pour saisir une chaîne de caractères multiligne
MaChaîne est une chaîne
MaChaîne = "Exemple de " + ...
"chaîne multiligne" Syntaxe
Chaîne 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înes sont considérés comme des retours chariots. Les tabulations ne sont pas prises en compte. <]> : 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 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înes sont considérés comme des retours chariots. Les tabulations ne sont pas prises en compte. <"> : 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 multiligne utilisant les triple points Masquer les détails
<Nom variable> = "<Contenu de la chaîne>"+ ...
"<Contenu de la chaîne 2>"
<Contenu de la chaîne> : Chaîne multiligne, saisie sur plusieurs lignes, avec guillemets. Chaque ligne est séparée par "+ ...". Remarques Utilisation de variables dans une chaîne multiligne Pour utiliser une variable dans une chaîne multiligne, il est possible : - soit d'interrompre la chaîne multiligne pour prendre en compte la variable.
Exemples :
sCode est une chaîne = ...
"La chaîne "+ ...
sVar + ...
" est une chaîne multiligne"
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 si la chaîne de caractères doit être traduite.
- soit d'utiliser dans la chaîne les caractères %1, %2, %n à la place des valeurs paramétrables, et utiliser ensuite la fonction ChaîneConstruit pour remplacer les paramètres de la chaîne par leurs valeurs.
Exemples :
sCode est une chaîne = "La chaîne %1 est une chaîne multiligne"
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)
Cette dernière solution est conseillée.
Avantages des chaînes multilignes utilisant les symboles [ et ] ou les guillemets - 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 des guillemets
L'utilisation des guillemets est plus intuitive pour utiliser une chaîne de caractères (qu'elle soit monoligne ou multiligne).
- Le nombre de lignes maximal d'une chaîne multiligne est 1000.
- Gestion des tabulations (TAB) dans les chaînes multilignes :
- Les chaînes multilignes définies avec les caractères "[" ne peuvent pas contenir de caractères TAB (tabulation). En effet, il n'est pas possible de différencier les tabulations présentes "dans la chaîne" des tabulations d'indentation du code.
- Les chaînes multilignes définies avec les guillemets permettent de gérer les caractères TAB (tabulation). Les tabulations contenues dans la chaîne sont conservées.
- 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
 ]
]
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|