En esta página

Unicode en Qt

Unicode es el estándar para la codificación de texto en casi todos los idiomas que se hablan en el mundo. Hoy en día se utiliza como codificación nativa para el texto en la mayoría de los sistemas operativos modernos. La principal excepción es Microsoft Windows, que sigue contando con un sistema dual que admite páginas de códigos y Unicode para las aplicaciones.

Clases de Qt para trabajar con cadenas

Estas clases son relevantes a la hora de trabajar con datos de cadenas de caracteres. Para obtener información sobre la representación de texto, consulta la descripción general del procesamiento de texto enriquecido y, si tus datos de cadenas de caracteres están en formato XML, consulta la descripción general del procesamiento de XML.

QAnyStringView

Vista unificada de cadenas Latin-1, UTF-8 o UTF-16 con un subconjunto de solo lectura de la API de QString

QByteArray

Matriz de bytes

QByteArrayList

Lista de matrices de bytes

QByteArrayMatcher

Almacena una secuencia de bytes que se puede comparar rápidamente en una matriz de bytes

QByteArrayView

Vista de un array de bytes con un subconjunto de solo lectura de la API de QByteArray

QChar

Carácter Unicode de 16 bits

QCollator

Compara cadenas según un algoritmo de colación localizado

QCollatorSortKey

Se puede utilizar para acelerar la colación de cadenas

QLatin1Char

Carácter ASCII/Latin-1 de 8 bits

QLatin1StringMatcher

Búsqueda optimizada de subcadenas en texto Latin-1

QLatin1StringView

Envoltura ligera alrededor de un literal de cadena codificado en US-ASCII/Latin-1

QLocale

Convierte entre números y sus representaciones como cadenas en varios idiomas

QRegularExpression

Coincidencia de patrones mediante expresiones regulares

QRegularExpressionMatch

Resultados de la coincidencia de un objeto QRegularExpression con una cadena

QRegularExpressionMatchIterator

Iterador sobre los resultados de una coincidencia global de un objeto QRegularExpression con una cadena

QStaticByteArrayMatcher

Versión en tiempo de compilación de QByteArrayMatcher

QStaticLatin1StringMatcher

Versión en tiempo de compilación de QLatin1StringMatcher

QString

Cadena de caracteres Unicode

QStringConverter

Clase base para la codificación y decodificación de texto

QStringDecoder

Decodificador de texto basado en estados

QStringEncoder

Codificador de texto basado en estados

QStringList

Lista de cadenas

QStringMatcher

Almacena una secuencia de caracteres que se pueden comparar rápidamente en una cadena Unicode

QStringRef

Envoltura ligera alrededor de subcadenas de QString

QStringTokenizer

Divide las cadenas en tokens según los separadores indicados

QStringView

Vista unificada de cadenas UTF-16 con un subconjunto de solo lectura de la API de QString

QTextBoundaryFinder

Método para localizar los límites de texto Unicode en una cadena

QTextStream

Interfaz práctica para leer y escribir texto

QUtf8StringView

Vista unificada de las cadenas UTF-8 con un subconjunto de solo lectura de la API de QString

Información sobre Unicode en la web

El Consorcio Unicode pone a disposición varios documentos, entre los que se incluyen

Unicode en Qt

En Qt, y en la mayoría de las aplicaciones que utilizan Qt, la mayoría o la totalidad de las cadenas visibles para el usuario se almacenan utilizando Unicode. Qt proporciona:

  • Conversión hacia y desde codificaciones heredadas para la E/S de archivos: véase QTextCodec y QTextStream.
  • Compatibilidad con métodos de entrada y teclados específicos de cada configuración regional.
  • Una clase de cadena, QString, que almacena caracteres Unicode, con soporte para la migración desde cadenas C, incluida la conversión rápida hacia y desde UTF-8, ISO 8859-1 y US-ASCII, y todas las operaciones habituales con cadenas.
  • Controles de interfaz de usuario compatibles con Unicode.
  • Segmentación de texto compatible con Unicode (QTextBoundaryFinder)
  • Saltos de línea y representación de texto compatibles con Unicode

Para sacar el máximo partido a Unicode, recomendamos utilizar QString para almacenar todas las cadenas visibles para el usuario, y realizar todas las operaciones de E/S de archivos de texto mediante QTextStream.

Todos los argumentos de función en Qt que puedan ser cadenas visibles para el usuario — QLabel::setText() y muchos otros— aceptan valores de tipo const QString &. QString proporciona un casting implícito desde const char *, de modo que expresiones como

label->setText("Password:");

funcionen. También hay una función, ` QObject::tr()`, que ofrece soporte para la traducción, de la siguiente manera:

label->setText(tr("Password:"));

QObject::tr() mapea de const char * a una cadena Unicode y utiliza objetos QTranslator instalables para realizar el mapeo.

Qt proporciona varias clases de « QTextCodec » integradas, es decir, clases que saben cómo realizar la conversión entre Unicode y codificaciones heredadas para dar soporte a programas que deben comunicarse con otros programas o leer/escribir archivos en formatos heredados.

La conversión hacia y desde const char * utiliza UTF-8. No obstante, las aplicaciones pueden encontrar fácilmente códecs para otras configuraciones regionales y configurar cualquier archivo abierto o conexión de red para que utilice un códec especial.

Dado que US-ASCII e ISO-8859-1 son tan comunes, también hay funciones especialmente rápidas para la conversión entre ambos. Por ejemplo, para abrir el icono de una aplicación se podría hacer lo siguiente:

QFile file(QString::fromLatin1("appicon.png"));

o

QFile file(QLatin1String("appicon.png"));

Qt admite la representación de texto en la mayoría de los idiomas escritos del mundo. La lista detallada de sistemas de escritura compatibles depende en cierta medida de la compatibilidad del sistema operativo y de la disponibilidad de fuentes en el sistema de destino.

Véase también Internacionalización con Qt.

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