Класс QTextBoundaryFinder

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

Заголовок:	#include <QTextBoundaryFinder>
qmake:	QT += core
С тех пор:	Qt 4.4

Этот класс был введён в Qt 4.4.

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

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

Общедоступные типы

Перечисление	BoundaryReason { NotAtBoundary, BreakOpportunity, StartOfItem, EndOfItem, MandatoryBreak, SoftHyphen }
Флаги	BoundaryReasons
Перечисление	BoundaryType { Графема, Слово, Строка, Предложение }

Общедоступные функции

	QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, const QChar *chars, int length, unsigned char *buffer = nullptr, int bufferSize = 0)
	QTextBoundaryFinder(QTextBoundaryFinder::BoundaryType type, const QString &string)
	QTextBoundaryFinder(const QTextBoundaryFinder &other)
	QTextBoundaryFinder()
QTextBoundaryFinder &	operator=(const QTextBoundaryFinder &other)
	~QTextBoundaryFinder()
QTextBoundaryFinder::BoundaryReasons	boundaryReasons() const
bool	isAtBoundary() const
bool	isValid() const
int	position() const
void	setPosition(int position)
QString	string() const
void	toEnd()
int	toNextBoundary()
int	toPreviousBoundary()
void	toStart()
QTextBoundaryFinder::BoundaryType	type() const

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

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

Константа	Значение	Описание
`QTextBoundaryFinder::NotAtBoundary`	`0`	Поиск границ не находится в позиции границы.
`QTextBoundaryFinder::BreakOpportunity`	`0x1f`	Поиск границ находится в позиции возможности разрыва. Такая возможность разрыва также может быть границей элемента (либо StartOfItem, либо EndOfItem, либо сочетанием обоих), обязательным разрывом строки или мягким дефисом.
`QTextBoundaryFinder::StartOfItem`	`0x20`	Начиная с версии 5.0. Поиск границ находится в начале графемы, слова, предложения или строки.
`QTextBoundaryFinder::EndOfItem`	`0x40`	Начиная с версии 5.0. Поиск границ находится в конце графемы, слова, предложения или строки.
`QTextBoundaryFinder::MandatoryBreak`	`0x80`	Начиная с версии 5.0. Поиск границ находится в конце строки (может встречаться только для типа границы Строка).
`QTextBoundaryFinder::SoftHyphen`	`0x100`	Поиск границ находится на мягком дефисе (может встречаться только для типа границы Строка).

Тип BoundaryReasons является псевдонимом для QFlags<BoundaryReason>. Он хранит результат логического ИЛИ комбинации значений BoundaryReason.

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

Константа	Значение	Описание
`QTextBoundaryFinder::Grapheme`	`0`	Находит графему, которая является самой маленькой границей. Она включает буквы, знаки препинания, цифры и многое другое.
`QTextBoundaryFinder::Word`	`1`	Находит слово.
`QTextBoundaryFinder::Line`	`3`	Находит возможные позиции для разрыва текста на несколько строк.
`QTextBoundaryFinder::Sentence`	`2`	Находит границы предложений. Они включают точки, знаки вопроса и т. д.

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

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

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

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

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

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 недействителен.

int QTextBoundaryFinder::position() const

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

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

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

void QTextBoundaryFinder::setPosition(int position)

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

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

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

QString QTextBoundaryFinder::string() const

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

void QTextBoundaryFinder::toEnd()

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

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

int QTextBoundaryFinder::toNextBoundary()

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

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

int QTextBoundaryFinder::toPreviousBoundary()

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

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

void QTextBoundaryFinder::toStart()

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