Класс QByteArrayMatcher

Класс QByteArrayMatcher хранит последовательность байтов, которые можно быстро сопоставить в массиве байтов. Подробнее...

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

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

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

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

Создайте QByteArrayMatcher с QByteArray, который вы хотите найти. Затем вызовите indexIn() на QByteArray, который вы хотите найти.

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

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

QByteArrayMatcher::QByteArrayMatcher(const QByteArrayMatcher &other)

Копирует совпадение массива байтов other в этот массив байтов.

QByteArrayMatcher::QByteArrayMatcher(const char *pattern, int length)

Создаёт совпадение массива байтов из pattern. pattern имеет заданную длину length. pattern должен оставаться в области видимости, но деструктор не удаляет pattern.

QByteArrayMatcher::QByteArrayMatcher(const QByteArray &pattern)

Создаёт совпадение массива байтов, которое будет искать pattern. Вызовите indexIn(), чтобы выполнить поиск.

QByteArrayMatcher::QByteArrayMatcher()

Создаёт пустое совпадение массива байтов, которое ничего не будет сопоставлять. Вызовите setPattern(), чтобы задать ему шаблон для сопоставления.

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

Присваивает совпадение массива байтов other этому совпадению массива байтов.

QByteArrayMatcher::~QByteArrayMatcher()

Удаляет совпадение массива байтов.

int QByteArrayMatcher::indexIn(const QByteArray &ba, int from = 0) const

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

int QByteArrayMatcher::indexIn(const char *str, int len, int from = 0) const

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

QByteArray QByteArrayMatcher::pattern() const

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

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

void QByteArrayMatcher::setPattern(const QByteArray &pattern)

Устанавливает массив байтов, который будет искать это совпадение массива байтов, в pattern.

См. также pattern() и indexIn().