string QML Value Type
Una cadena de texto de formato libre. Más...
| Since: | Qt 6.12 |
Descripción detallada
El tipo « string » hace referencia a una cadena de texto de formato libre entre comillas, por ejemplo, «¡Hola, mundo!». El lenguaje QML proporciona este tipo de valor de forma predeterminada.
Ejemplo:
Text { text: "Hello world!" }Las propiedades de tipo « string » están vacías por defecto.
Las cadenas tienen un atributo « length » que contiene el número de caracteres de la cadena.
El tipo de valor «cadena» se basa en el tipo C++ ` QString`. Amplía el tipo primitivo «String» de JavaScript, ya que proporciona gran parte de la misma API, además de algunos métodos adicionales. Por ejemplo, el método del tipo de valor «cadena» de QML ` arg() ` admite la sustitución de valores:
var message = "There are %1 items"
var count = 20
console.log(message.arg(count)) // "There are 20 items"El método ` arg() ` también admite múltiples argumentos, lo que permite sustituir varios marcadores de posición en una sola llamada:
var message = "%1 of %2 files copied. Errors: %3"
console.log(message.arg(5, 7, 0)) // "5 of 7 files copied. Errors: 0"El uso de varios argumentos resulta más eficiente que encadenar llamadas a ` arg() ` y evita problemas cuando los propios argumentos contienen marcadores de posición:
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)El tipo de valor de cadena de QML admite la mayoría de las características de las cadenas de ECMAScript, como los literales de plantilla (cadena), la interpolación de cadenas, las cadenas multilínea y los bucles sobre cadenas.
En general, las cadenas de QML admiten la mayoría de los métodos de cadena de JavaScript, incluyendo la comprobación de inclusión mediante ` string.includes()`, ` string.startsWith()` y ` string.endsWith()`; la repetición de una cadena mediante ` string.repeats()`; y el corte y la división mediante ` string.slice() ` y ` string.split()`.
Para obtener más información sobre qué versión de ECMAScript es compatible con QML, consulta Entorno de ejecución de JavaScript
Para obtener más información sobre los métodos de cadena de JavaScript, consulte «mdn JavaScript String»
Al integrar con C++, ten en cuenta que cualquier valor de tipo « QString » pasado a QML desde C++ se convierte automáticamente en un valor de tipo « string », y viceversa.
Véase también «Tipos de valor de QML » y la «Especificación del lenguaje ECMAScript».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.