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 []
  • Limites
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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 ]
  • les triples points (...)
Versions 16 et supérieures
Universal Windows 10 App Cette fonctionnalité est disponible pour les applications Windows Phone.
Nouveauté 16
Universal Windows 10 App Cette fonctionnalité est disponible pour les applications Windows Phone.
Universal Windows 10 App Cette fonctionnalité est disponible pour les applications Windows Phone.
Versions 17 et supérieures
iPhone/iPad Cette fonctionnalité est disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonctionnalité est disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonctionnalité est disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonctionnalité est disponible en mode Windows Store apps.
Widget Android Cette fonctionnalité est disponible en mode Widget Android.
Nouveauté 18
Universal Windows 10 App Cette fonctionnalité est disponible en mode Windows Store apps.
Widget Android Cette fonctionnalité est disponible en mode Widget Android.
Universal Windows 10 App Cette fonctionnalité est disponible en mode Windows Store apps.
Widget Android Cette fonctionnalité est disponible en mode Widget Android.
Versions 21 et supérieures
Universal Windows 10 App Cette fonctionnalité est disponible en mode Universal Windows 10 App.
Apple Watch Cette fonctionnalité est disponible en mode Apple Watch.
Nouveauté 21
Universal Windows 10 App Cette fonctionnalité est disponible en mode Universal Windows 10 App.
Apple Watch Cette fonctionnalité est disponible en mode Apple Watch.
Universal Windows 10 App Cette fonctionnalité est disponible en mode Universal Windows 10 App.
Apple Watch Cette fonctionnalité est disponible en mode Apple Watch.
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
]
// 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 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.
    Exemple :
    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
    ]

    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.
    Exemple :
    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)

    Cette dernière solution est conseillée.

Avantages des chaînes multilignes utilisant les symboles []

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

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