Класс QByteArrayMatcher

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

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

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

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

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

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

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

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

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

QByteArrayMatcher::QByteArrayMatcher()

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

QByteArrayMatcher::QByteArrayMatcher(const QByteArray &pattern)

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

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

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

QByteArrayMatcher::QByteArrayMatcher(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().

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

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