Класс QStaticByteArrayMatcher

Класс QStaticByteArrayMatcher — это версия QByteArrayMatcher, вычисляемая на этапе компиляции. Подробнее...

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

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

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

Связанные нечлены

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

Этот класс полезен, когда у вас есть последовательность байтов, которую вы хотите многократно сопоставлять с некоторыми массивами байтов (например, в цикле) или когда вы хотите найти одну и ту же последовательность байтов несколько раз в одном массиве байтов. Использование объекта-сопоставителя и indexIn() быстрее, чем сопоставление обычного QByteArray с QByteArray::indexOf(), особенно если повторяющееся сопоставление происходит многократно.

В отличие от QByteArrayMatcher, этот класс вычисляет внутреннее представление на этапе компиляции, если ваш компилятор поддерживает C++14 (constexpr (C++11 недостаточно), поэтому он может быть полезным даже при однократных сопоставлениях массивов байтов.

Создайте QStaticByteArrayMatcher, вызвав qMakeStaticByteArrayMatcher(), передав ему строковый литерал C, который вы хотите найти. Сохраните возвращаемое значение этой функции в переменной static const auto, чтобы вам не нужно было явно передавать N параметр шаблона:

static const auto matcher = qMakeStaticByteArrayMatcher("needle");

Затем вызовите indexIn() на QByteArray, в котором вы хотите искать, точно так же, как и с QByteArrayMatcher.

Поскольку этот класс разработан для выполнения всех предварительных вычислений на этапе компиляции, он не предоставляет метод setPattern().

Примечание: Qt обнаруживает необходимую поддержку компилятора C++14, используя рекомендации по проверке возможностей из C++ Committee's Standing Document 6.

См. также QByteArrayMatcher и QStringMatcher.

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

int QStaticByteArrayMatcher::indexIn(const QByteArray &haystack, int from = ...) const

Ищет в строке символов haystack, начиная с байтовой позиции from (по умолчанию 0, т.е. с первого байта), массив байтов pattern(), установленный в конструкторе.

Возвращает позицию, где pattern() совпал в haystack, или -1, если совпадения не найдено.

int QStaticByteArrayMatcher::indexIn(const char *haystack, int hlen, int from = ...) const

Ищет в строке символов haystack, имеющей длину hlen, начиная с байтовой позиции from (по умолчанию 0, т.е. с первого байта), массив байтов pattern(), установленный в конструкторе.

Возвращает позицию, где pattern() совпал в haystack, или -1, если совпадения не найдено.

QByteArray QStaticByteArrayMatcher::pattern() const

Возвращает массив байтов шаблона, который будет искать этот сопоставитель массивов байтов.

См. также QByteArrayMatcher::setPattern().

static const auto matcher = qMakeStaticByteArrayMatcher("needle");