PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Utilisation de variables dans une chaîne multiligne
  • Avantages des chaînes multilignes utilisant les symboles [ et ] ou les guillemets
  • Limites
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 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 ].
  • Versions 27 et supérieures
    les guillemets.
    Nouveauté 27
    les guillemets.
    les guillemets.
  • les triples points (...).
Versions 21 et supérieures
Universal Windows 10 App Cette fonctionnalité est disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonctionnalité est disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonctionnalité est disponible en mode Universal Windows 10 App.
Exemple
// 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
]
Versions 27 et supérieures
MaChaîne est une chaîne
MaChaîne = "
Exemple de
chaîne multiligne
"
Nouveauté 27
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.
Versions 27 et supérieures

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.
Nouveauté 27

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

    Versions 27 et supérieures
    s est une chaîne = "
    la chaîne
    " + var + "
    est multiligne
    "
    Nouveauté 27
    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)

    Versions 27 et supérieures
    sChaîne est une chaîne = "
    la chaîne %1
    est multiligne
    "
    sChaîne = ChaîneConstruit(sChaîne, MaVariable)
    Nouveauté 27
    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.
  • Versions 27 et supérieures
    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).
    Nouveauté 27
    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).
    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).

Limites

  • Le nombre de lignes maximal d'une chaîne multiligne est 1000.
  • Les chaînes multilignes 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.
  • 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
     ]
    ]
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire