QTextBoundaryFinder Class
La clase QTextBoundaryFinder permite localizar los límites de texto Unicode en una cadena. Más información...
| Encabezado: | #include <QTextBoundaryFinder> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QTextBoundaryFinder forma parte de las clases de uso compartido implícito y de las clases para datos de cadena.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
| enum | BoundaryReason { NotAtBoundary, BreakOpportunity, StartOfItem, EndOfItem, MandatoryBreak, SoftHyphen } |
| flags | BoundaryReasons |
| enum | BoundaryType { Grapheme, Word, Line, Sentence } |
Funciones públicas
| QTextBoundaryFinder() | |
| QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, const QString &string) | |
(since 6.0) | QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, QStringView string, unsigned char *buffer = nullptr, qsizetype bufferSize = 0) |
| QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, const QChar *chars, qsizetype length, unsigned char *buffer = nullptr, qsizetype bufferSize = 0) | |
| QTextBoundaryFinder(const QTextBoundaryFinder &other) | |
(since 6.11) | QTextBoundaryFinder(QTextBoundaryFinder &&other) |
| ~QTextBoundaryFinder() | |
| QTextBoundaryFinder::BoundaryReasons | boundaryReasons() const |
| bool | isAtBoundary() const |
| bool | isValid() const |
| qsizetype | position() const |
| void | setPosition(qsizetype position) |
| QString | string() const |
(since 6.11) void | swap(QTextBoundaryFinder &other) |
| void | toEnd() |
| qsizetype | toNextBoundary() |
| qsizetype | toPreviousBoundary() |
| void | toStart() |
| QTextBoundaryFinder::BoundaryType | type() const |
(since 6.11) QTextBoundaryFinder & | operator=(QTextBoundaryFinder &&other) |
| QTextBoundaryFinder & | operator=(const QTextBoundaryFinder &other) |
Descripción detallada
QTextBoundaryFinder permite encontrar límites de texto Unicode en una cadena, de acuerdo con la especificación de límites de texto Unicode (véanse el Anexo n.º 14 y el Anexo n.º 29 del Estándar Unicode).
QTextBoundaryFinder puede operar sobre un objeto ` QString ` en cuatro modos posibles, dependiendo del valor de ` BoundaryType`.
Las unidades de caracteres Unicode que conforman lo que el usuario considera un carácter o una unidad básica del idioma se denominan aquí «grupos de grafemas». Los dos caracteres Unicode «A» + diéresis, por ejemplo, forman un grupo de grafemas, ya que el usuario los considera un solo carácter; sin embargo, en este caso se representan mediante dos puntos de código Unicode (véase https://www.unicode.org/reports/tr29/#Grapheme_Cluster_Boundaries).
Los límites de palabra sirven para localizar el inicio y el final de lo que un idioma considera una palabra (véase https://www.unicode.org/reports/tr29/#Word_Boundaries).
Los límites de salto de línea indican los posibles puntos en los que podría producirse un salto de línea, y los límites de frase muestran el inicio y el final de frases completas (véase https://www.unicode.org/reports/tr29/#Sentence_Boundaries y https://www.unicode.org/reports/tr14/).
La primera posición de una cadena siempre es un límite válido y se refiere a la posición anterior al primer carácter. La última posición, que coincide con la longitud de la cadena, también es válida y se refiere a la posición posterior al último carácter.
Documentación sobre los tipos de miembros
enum QTextBoundaryFinder::BoundaryReason
flags QTextBoundaryFinder::BoundaryReasons
| Constante | Valor | Descripción |
|---|---|---|
QTextBoundaryFinder::NotAtBoundary | 0 | El localizador de límites no se encuentra en una posición de límite. |
QTextBoundaryFinder::BreakOpportunity | 0x1f | El localizador de límites se encuentra en una posición de oportunidad de salto. Dicha oportunidad de salto también podría ser un límite de elemento (ya sea StartOfItem, EndOfItem o una combinación de ambos), un salto de línea obligatorio o un guion flexible. |
QTextBoundaryFinder::StartOfItem (since Qt 5.0) | 0x20 | El localizador de límites se encuentra al inicio de un grafema, una palabra, una frase o una línea. |
QTextBoundaryFinder::EndOfItem (since Qt 5.0) | 0x40 | El localizador de límites se encuentra al final de un grafema, una palabra, una frase o una línea. |
QTextBoundaryFinder::MandatoryBreak (since Qt 5.0) | 0x80 | El localizador de límites se encuentra al final de la línea (solo puede darse en el tipo de límite «Línea»). |
QTextBoundaryFinder::SoftHyphen | 0x100 | El detector de límites se encuentra en el guion flexible (solo puede darse en el tipo de límite «Línea»). |
El tipo «BoundaryReasons» es una definición de tipo para «QFlags<BoundaryReason>». Almacena una combinación OR de valores de «BoundaryReason».
enum QTextBoundaryFinder::BoundaryType
| Constante | Valor | Descripción |
|---|---|---|
QTextBoundaryFinder::Grapheme | 0 | Busca un grafema que sea el límite más pequeño. Incluye letras, signos de puntuación, números y más. |
QTextBoundaryFinder::Word | 1 | Busca una palabra. |
QTextBoundaryFinder::Line | 3 | Busca las posibles posiciones para dividir el texto en varias líneas. |
QTextBoundaryFinder::Sentence | 2 | Busca los límites de las oraciones. Estos incluyen puntos, signos de interrogación, etc. |
Documentación de funciones de miembro
QTextBoundaryFinder::QTextBoundaryFinder()
Crea un objeto QTextBoundaryFinder no válido.
QTextBoundaryFinder::QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, const QString &string)
Crea un objeto `QTextBoundaryFinder` de tipo ` type ` que opera sobre un ` string`.
[since 6.0] QTextBoundaryFinder::QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, QStringView string, unsigned char *buffer = nullptr, qsizetype bufferSize = 0)
Crea un objeto QTextBoundaryFinder de tipo ` type ` que opera sobre ` string`.
buffer es un búfer de trabajo opcional de tamaño bufferSize que se puede pasar a QTextBoundaryFinder. Si el búfer es lo suficientemente grande como para contener los datos de trabajo necesarios (bufferSize >= length + 1), utilizará este en lugar de asignar su propio búfer.
Advertencia: QTextBoundaryFinder no crea una copia de string. Es responsabilidad del programador de la aplicación asegurarse de que la matriz permanezca asignada mientras el objeto QTextBoundaryFinder siga activo. Lo mismo se aplica a buffer.
Esta función se introdujo en Qt 6.0.
QTextBoundaryFinder::QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, const QChar *chars, qsizetype length, unsigned char *buffer = nullptr, qsizetype bufferSize = 0)
Es lo mismo que QTextBoundaryFinder(type, QStringView(chars, length), buffer, bufferSize).
Se trata de una función sobrecargada.
QTextBoundaryFinder::QTextBoundaryFinder(const QTextBoundaryFinder &other)
Copia el objeto QTextBoundaryFinder, other.
[noexcept, since 6.11] QTextBoundaryFinder::QTextBoundaryFinder(QTextBoundaryFinder &&other)
La función «move» crea un nuevo objeto `QTextBoundaryFinder` a partir de ` other`.
Nota: El objeto «other», del que se ha realizado el traslado, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.
Esta función se introdujo en Qt 6.11.
[noexcept] QTextBoundaryFinder::~QTextBoundaryFinder()
Destruye el objeto « QTextBoundaryFinder ».
QTextBoundaryFinder::BoundaryReasons QTextBoundaryFinder::boundaryReasons() const
Devuelve los motivos por los que el buscador de límites ha elegido la posición actual como límite.
bool QTextBoundaryFinder::isAtBoundary() const
Devuelve ` true ` si la función ` position()` del objeto se encuentra actualmente en un límite de texto válido.
bool QTextBoundaryFinder::isValid() const
Devuelve ` true ` si el identificador de límites de texto es válido; en caso contrario, devuelve ` false`. El valor por defecto ` QTextBoundaryFinder ` no es válido.
qsizetype QTextBoundaryFinder::position() const
Devuelve la posición actual de la cadena « QTextBoundaryFinder ».
El rango va desde 0 (el principio de la cadena) hasta la longitud de la cadena, ambas incluidas.
Véase también setPosition().
void QTextBoundaryFinder::setPosition(qsizetype position)
Establece la posición actual del « QTextBoundaryFinder » en « position ».
Si position está fuera de los límites, se restringirá únicamente a posiciones válidas. En este caso, las posiciones válidas van desde 0 hasta la longitud de la cadena, ambas incluidas.
Véase también position().
QString QTextBoundaryFinder::string() const
Devuelve la cadena sobre la que opera el objeto ` QTextBoundaryFinder `.
[noexcept, since 6.11] void QTextBoundaryFinder::swap(QTextBoundaryFinder &other)
Sustituye este buscador de límites de texto por other. Esta operación es muy rápida y nunca falla.
Esta función se introdujo en Qt 6.11.
void QTextBoundaryFinder::toEnd()
Desplaza el cursor al final de la cadena. Esto equivale a « setPosition » (string.length()).
Véase también setPosition() y position().
qsizetype QTextBoundaryFinder::toNextBoundary()
Desplaza el « QTextBoundaryFinder » a la siguiente posición límite y devuelve dicha posición.
Devuelve -1 si no hay un límite siguiente.
qsizetype QTextBoundaryFinder::toPreviousBoundary()
Mueve el objeto « QTextBoundaryFinder » a la posición del límite anterior y devuelve dicha posición.
Devuelve -1 si no hay ningún límite anterior.
void QTextBoundaryFinder::toStart()
Sitúa el cursor al principio de la cadena. Esto equivale a setPosition(0).
Véase también « setPosition()» y « position()».
QTextBoundaryFinder::BoundaryType QTextBoundaryFinder::type() const
Devuelve el tipo de ` QTextBoundaryFinder`.
[noexcept, since 6.11] QTextBoundaryFinder &QTextBoundaryFinder::operator=(QTextBoundaryFinder &&other)
La operación «move-assigns» asigna « other » a esta instancia de « QTextBoundaryFinder ».
Nota: El objeto «other», del que se ha realizado la asignación por movimiento, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.
Esta función se introdujo en Qt 6.11.
QTextBoundaryFinder &QTextBoundaryFinder::operator=(const QTextBoundaryFinder &other)
Asigna el objeto « other » a otro objeto « QTextBoundaryFinder ».
© 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.