Класс QStaticByteArrayMatcher

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

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

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

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

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

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

Этот класс полезен, когда у вас есть последовательность байтов, которую вы хотите многократно сопоставлять с некоторыми массивами байтов (возможно, в цикле), или когда вы хотите найти ту же последовательность байтов несколько раз в одном массиве байтов. Использование объекта соответствия и 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");