Класс 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++ 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

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

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

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