string QML Value Type

Une chaîne de texte libre. En savoir plus...

Description détaillée

Le type « string » désigne une chaîne de texte libre entre guillemets, par exemple «Hello world!». Le langage QML fournit ce type de valeur par défaut.

Exemple :

Text { text: "Hello world!" }

Les propriétés de type « string » sont vides par défaut.

Les chaînes de caractères disposent d'un attribut « length » qui contient le nombre de caractères de la chaîne.

Le type de valeur « chaîne de caractères » s'appuie sur le type C++ « QString ». Il étend le type primitif « String » de JavaScript en fournissant une API en grande partie identique, ainsi que quelques méthodes supplémentaires. Par exemple, la méthode « arg() » du type de valeur « chaîne de caractères » de QML prend en charge la substitution de valeurs :

var message = "There are %1 items"
var count = 20
console.log(message.arg(count))  // "There are 20 items"

La méthode ` arg() ` prend également en charge plusieurs arguments, ce qui vous permet de remplacer plusieurs espaces réservés en un seul appel :

var message = "%1 of %2 files copied. Errors: %3"
console.log(message.arg(5, 7, 0))  // "5 of 7 files copied. Errors: 0"

L’utilisation de plusieurs arguments est plus efficace que le chaînage d’appels à ` arg() ` et évite les problèmes lorsque les arguments eux-mêmes contiennent des espaces réservés :

var result = "%1 %2".arg("%1f", "Hello")  // "%1f Hello" (correct)
// Compare with chained calls:
var result = "%1 %2".arg("%1f").arg("Hello")  // "Hellof %2" (incorrect)

Le type de valeur chaîne QML prend en charge la plupart des fonctionnalités des chaînes ECMAScript, telles que les littéraux de modèle (chaîne), l’interpolation de chaînes, les chaînes multilignes et les boucles sur les chaînes.

En général, les chaînes QML prennent en charge la plupart des méthodes JavaScript relatives aux chaînes, notamment la vérification de l'inclusion à l'aide de ` string.includes()`, ` string.startsWith()` et ` string.endsWith()` ; la répétition d'une chaîne à l'aide de ` string.repeats()` ; ainsi que le découpage et la segmentation à l'aide de ` string.slice() ` et ` string.split()`.

Pour plus d’informations sur la version d’ECMAScript prise en charge par QML, consultez la section Environnement hôte JavaScript

Pour plus d’informations sur les méthodes de chaîne de caractères JavaScript, consultez la page MDN « JavaScript String »

Lors de l’intégration avec C++, notez que toute valeur de type « QString » transmise à QML depuis C++ est automatiquement convertie en une valeur de type « string », et inversement.

Voir également «Types de valeurs QML » et « Spécification du langage ECMAScript ».