En esta página

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

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

ConstanteValorDescripción
QTextBoundaryFinder::NotAtBoundary0El localizador de límites no se encuentra en una posición de límite.
QTextBoundaryFinder::BreakOpportunity0x1fEl 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)0x20El 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)0x40El 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)0x80El localizador de límites se encuentra al final de la línea (solo puede darse en el tipo de límite «Línea»).
QTextBoundaryFinder::SoftHyphen0x100El 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

ConstanteValorDescripción
QTextBoundaryFinder::Grapheme0Busca un grafema que sea el límite más pequeño. Incluye letras, signos de puntuación, números y más.
QTextBoundaryFinder::Word1Busca una palabra.
QTextBoundaryFinder::Line3Busca las posibles posiciones para dividir el texto en varias líneas.
QTextBoundaryFinder::Sentence2Busca 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.