Класс QTextBoundaryFinder

Класс QTextBoundaryFinder предоставляет способ нахождения границ текста Юникода в строке. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются повторно входящими.

Открытые типы

Открытые функции

Подробное описание

QTextBoundaryFinder позволяет находить границы текста Юникода в строке в соответствии со спецификацией границ текста Юникода (см. Приложение к стандарту Юникода № 14 и Приложение к стандарту Юникода № 29).

QTextBoundaryFinder может работать со строкой QString в четырёх возможных режимах в зависимости от значения BoundaryType.

Единицы символов Юникода, образующие то, что пользователь воспринимает как символ или основную единицу языка, здесь называются кластерами графем. Например, два символа Юникода 'A' + диэрез образуют один кластер графем, поскольку пользователь воспринимает их как один символ, но в этом случае он представлен двумя кодовыми точками Юникода (см. http://www.unicode.org/reports/tr29/#Grapheme_Cluster_Boundaries).

Границы слов предназначены для определения начала и конца того, что язык рассматривает как слово (см. http://www.unicode.org/reports/tr29/#Word_Boundaries).

Границы разрывов строк показывают возможные места, где может произойти разрыв строки, а границы предложений показывают начало и конец целых предложений (см. http://www.unicode.org/reports/tr29/#Sentence_Boundaries и http://www.unicode.org/reports/tr14/).

Первая позиция в строке всегда является допустимой границей и относится к позиции перед первым символом. Последняя позиция в длине строки также допустима и относится к позиции после последнего символа.

Документация по типу члена

перечисление QTextBoundaryFinder::BoundaryReasonфлаги QTextBoundaryFinder::BoundaryReasons

Тип BoundaryReasons является типом-псевдонимом для QFlags<BoundaryReason>. Он хранит комбинацию значений BoundaryReason, объединённых операцией OR.

перечисление QTextBoundaryFinder::BoundaryType

Документация по функции члена

[since 6.0] QTextBoundaryFinder::QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, QStringView string, unsigned char *buffer = nullptr, qsizetype bufferSize = 0)

Создаёт объект QTextBoundaryFinder типа type, работающий со строкой string.

buffer — это необязательный рабочий буфер размером bufferSize, который можно передать объекту QTextBoundaryFinder. Если буфер достаточно велик, чтобы содержать необходимые рабочие данные (bufferSize >= length + 1), он будет использоваться вместо выделения собственного буфера.

Предупреждение: QTextBoundaryFinder не создаёт копию string. Программисту приложения необходимо убедиться, что массив выделен до тех пор, пока объект QTextBoundaryFinder жив. То же самое относится к buffer.

Эта функция была добавлена в Qt 6.0.

QTextBoundaryFinder::QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, const QChar *chars, qsizetype length, unsigned char *buffer = nullptr, qsizetype bufferSize = 0)

Это перегруженный метод.

То же самое, что и QTextBoundaryFinder(type, QStringView(chars, length), buffer, bufferSize).

QTextBoundaryFinder::QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, const QString &string)

Создаёт объект QTextBoundaryFinder типа type, работающий со строкой string.

QTextBoundaryFinder::QTextBoundaryFinder(const QTextBoundaryFinder &other)

Копирует объект QTextBoundaryFinder, other.

QTextBoundaryFinder::QTextBoundaryFinder()

Конструирует недопустимый объект QTextBoundaryFinder.

QTextBoundaryFinder &QTextBoundaryFinder::operator=(const QTextBoundaryFinder &other)

Присваивает объект other другому объекту QTextBoundaryFinder.

QTextBoundaryFinder::~QTextBoundaryFinder()

Деструктор объекта QTextBoundaryFinder.

QTextBoundaryFinder::BoundaryReasons QTextBoundaryFinder::boundaryReasons() const

Возвращает причины, по которым поиск границ установил текущую позицию как границу.

bool QTextBoundaryFinder::isAtBoundary() const

Возвращает true если текущая позиция объекта position() находится на границе текста.

bool QTextBoundaryFinder::isValid() const

Возвращает true если поиск границ текста валиден; в противном случае возвращает false. По умолчанию объект QTextBoundaryFinder невалиден.

qsizetype QTextBoundaryFinder::position() const

Возвращает текущую позицию объекта QTextBoundaryFinder.

Диапазон от 0 (начало строки) до длины строки включительно.

См. также setPosition().

void QTextBoundaryFinder::setPosition(qsizetype position)

Устанавливает текущую позицию объекта QTextBoundaryFinder в position.

Если position находится вне границ, она будет ограничена допустимыми позициями. В этом случае допустимые позиции — от 0 до длины строки включительно.

См. также position().

QString QTextBoundaryFinder::string() const

Возвращает строку, с которой работает объект QTextBoundaryFinder.

void QTextBoundaryFinder::toEnd()

Перемещает поиск до конца строки. Эквивалентно setPosition(string.length()).

См. также setPosition() и position().

qsizetype QTextBoundaryFinder::toNextBoundary()

Перемещает QTextBoundaryFinder к следующей позиции границы и возвращает её.

Возвращает -1, если нет следующей границы.

qsizetype QTextBoundaryFinder::toPreviousBoundary()

Перемещает QTextBoundaryFinder к предыдущей позиции границы и возвращает её.

Возвращает -1, если нет предыдущей границы.

void QTextBoundaryFinder::toStart()

Перемещает поиск к началу строки. Эквивалентно setPosition(0).

См. также setPosition() и position().

QTextBoundaryFinder::BoundaryType QTextBoundaryFinder::type() const

Возвращает тип объекта QTextBoundaryFinder.