std::experimental::boyer_moore_searcher, std::experimental::make_boyer_moore_searcher
| Определён в заголовке <experimental/functional>
|
||
template< class RandomIt1,
class Hash = std::hash<typename std::iterator_traits<RandomIt1>::value_type>,
class BinaryPredicate = std::equal_to<> >
class boyer_moore_searcher;
|
(library fundamentals TS) | |
Поисковик, подходящий для использования с std::experimental::search, который реализует строковый поисковый алгоритм Бойера-Мура.
boyer_moore_searcher является CopyConstructible и CopyAssignable.
RandomIt1 должен соответствовать требованиям LegacyRandomAccessIterator.
Функции-члены
std::experimental::boyer_moore_searcher::boyer_moore_searcher
boyer_moore_searcher( RandomIt1 pat_first,
RandomIt1 pat_last,
Hash hf = Hash(),
BinaryPredicate pred = BinaryPredicate() );
|
||
Конструирует boyer_moore_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_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 | - | пара итераторов, определяющая строку для исследования |
Возвращаемое значение
|
Если шаблон
В противном случае, итератор на первую позицию в
|
(до C++17) |
|
Если шаблон
В противном случае, возвращает пару итераторов на первую и следующую за последней позиции в
|
(начиная с C++17) |
Вспомогательные функции
template< class RandomIt,
class Hash = std::hash<typename std::iterator_traits<RandomIt>::value_type>,
class BinaryPredicate = std::equal_to<> >
boyer_moore_searcher<RandomIt, Hash, BinaryPredicate> make_boyer_moore_searcher(
RandomIt pat_first,
RandomIt pat_last,
Hash hf = Hash(),
BinaryPredicate pred = BinaryPredicate());
|
(library fundamentals TS) | |
Вспомогательная функция, которая создает std::experimental::boyer_moore_searcher с использованием вывода аргументов шаблона. Эквивалентно return boyer_moore_searcher<RandomIt, Hash, BinaryPredicate>(pat_first, pat_last, hf, pred);
Параметры
| pat_first, pat_last | - | пара итераторов, обозначающих строку для поиска |
| hf | - | вызываемый объект, используемый для хеширования элементов строки |
| pred | - | вызываемый объект, используемый для определения равенства |
Возвращаемое значение
Объект
boyer_moore_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_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
См. также
| ищет первое вхождение диапазона элементов (шаблон функции & функциональный объект алгоритма) | |
(C++20) |