Namespaces
Variants

std::experimental:: boyer_moore_horspool_searcher, std::experimental:: make_boyer_moore_horspool_searcher

From ru.cppreference.net
Определено в заголовочном файле <experimental/functional>
template < class RandomIt1,

class Hash = std:: hash < typename std:: iterator_traits < RandomIt1 > :: value_type > ,
class BinaryPredicate = std:: equal_to <> >

class boyer_moore_horspool_searcher ;
(library fundamentals TS)

Поисковик, подходящий для использования с std::experimental::search , который реализует алгоритм поиска строк Бойера-Мура-Хорспула .

boyer_moore_horspool_searcher является CopyConstructible и CopyAssignable .

RandomIt1 должен удовлетворять требованиям LegacyRandomAccessIterator .

Содержание

Функции-члены

std::experimental::boyer_moore_horspool_searcher::boyer_moore_horspool_searcher

boyer_moore_horspool_searcher( RandomIt1 pat_first,
                               RandomIt1 pat_last,
                               Hash hf = Hash(),
                               BinaryPredicate pred = BinaryPredicate() );

Создает boyer_moore_horspool_searcher, сохраняя копии pat_first, pat_last, hf и pred, настраивая любые необходимые внутренние структуры данных.

Тип значения RandomIt1 должен быть DefaultConstructible, CopyConstructible и CopyAssignable.

Для любых двух значений A и B типа std::iterator_traits<RandomIt1>::value_type, если pred(A, B) == true, то hf(A) == hf(B) должно быть true.

Параметры

pat_first, pat_last - пара итераторов, определяющая строку для поиска
hf - вызываемый объект для хеширования элементов строки
pred - вызываемый объект для определения равенства

Исключения

Любые исключения, выбрасываемые

  • конструктором копирования RandomIt1;
  • конструктором по умолчанию, конструктором копирования или оператором присваивания копированием типа значения RandomIt1; или
  • конструктором копирования или оператором вызова функции BinaryPredicate или Hash.

Также может выбрасывать std::bad_alloc, если дополнительная память, требуемая для внутренних структур данных, не может быть выделена.

std::experimental::boyer_moore_horspool_searcher::operator()

template< class RandomIt2 >
RandomIt2 operator()( RandomIt2 first, RandomIt2 last ) const;
(до C++17)
template< class RandomIt2 >
std::pair<RandomIt2,RandomIt2> operator()( RandomIt2 first, RandomIt2 last ) const;
(начиная с C++17)

Эта функция-член вызывается std::experimental::search для выполнения поиска с помощью данного искателя. RandomIt2 должен удовлетворять требованиям LegacyRandomAccessIterator.

RandomIt1 и RandomIt2 должны иметь одинаковый тип значения.

Параметры

first, last - пара итераторов, обозначающая строку для проверки

Возвращаемое значение

Если шаблон [ pat_first , pat_last ) пуст, возвращает first .

В противном случае, итератор на первую позицию в [ first , last ) , где находится подпоследовательность, равная [ pat_first , pat_last ) , как определено pred , или копия last в противном случае.

(до C++17)

Если шаблон [ pat_first , pat_last ) пуст, возвращает make_pair ( first, first ) .

В противном случае, возвращает пару итераторов на первую и следующую за последней позиции в [ first , last ) , где находится подпоследовательность, равная [ pat_first , pat_last ) , как определено pred , или make_pair ( last, last ) в противном случае.

(начиная с C++17)

Вспомогательные функции

template< class RandomIt,
          class Hash = std::hash<typename
                                 std::iterator_traits<RandomIt>::value_type>,
          class BinaryPredicate = std::equal_to<> >
boyer_moore_horspool_searcher<RandomIt, Hash, BinaryPredicate>
    make_boyer_moore_horspool_searcher( RandomIt pat_first,
                                        RandomIt pat_last,
                                        Hash hf = Hash(),
                                        BinaryPredicate pred = BinaryPredicate()
    );
(library fundamentals TS)

Вспомогательная функция, которая конструирует std::experimental::boyer_moore_horspool_searcher используя вывод аргументов шаблона. Эквивалентно return boyer_moore_horspool_searcher<RandomIt, Hash, BinaryPredicate>(pat_first, pat_last, hf, pred);

Параметры

pat_first, pat_last - пара итераторов, обозначающих строку для поиска
hf - вызываемый объект, используемый для хеширования элементов строки
pred - вызываемый объект, используемый для определения равенства

Возвращаемое значение

Объект boyer_moore_horspool_searcher , созданный с аргументами pat_first , pat_last , hf и pred .

Пример

#include <experimental/algorithm>
#include <experimental/functional>
#include <iostream>
#include <string>
int main()
{
    std::string in = "Lorem ipsum dolor sit amet, consectetur adipiscing elit,"
                     " sed do eiusmod tempor incididunt ut labore et dolore magna aliqua";
    std::string needle = "pisci";
    auto it = std::experimental::search(in.begin(), in.end(),
                  std::experimental::make_boyer_moore_horspool_searcher(
                      needle.begin(), needle.end()));
    if (it != in.end())
        std::cout << "The string " << needle << " found at offset "
                  << it - in.begin() << '\n';
    else
        std::cout << "The string " << needle << " not found\n";
}

Вывод:

The string pisci found at offset 43

См. также

ищет первое вхождение диапазона элементов
(шаблон функции &объект-функция алгоритма)