Класс QByteArrayMatcher

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

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

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

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

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

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

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

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

QByteArrayMatcher::QByteArrayMatcher(const QByteArrayMatcher &other)

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

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

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

QByteArrayMatcher::QByteArrayMatcher(const QByteArray &pattern)

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

QByteArrayMatcher::QByteArrayMatcher()

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

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

Присваивает other массив байтов matchera этому массиву байтов.

QByteArrayMatcher::~QByteArrayMatcher()

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

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

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

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

void QByteArrayMatcher::setPattern(const QByteArray &pattern)

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

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