std::boyer_moore_searcher
Определён в заголовке <functional> | ||
|---|---|---|
template< class RandomIt1,
class Hash = std::hash<typename std::iterator_traits<RandomIt1>::value_type>,
class BinaryPredicate = std::equal_to<> >
class boyer_moore_searcher;
| (начиная с C++17) |
Средство поиска, подходящее для использования с перегрузкой Searcher функции std::search, реализующее алгоритм поиска строк Бойера — Мура.
std::boyer_moore_searcher является CopyConstructible и CopyAssignable.
RandomIt1 должен соответствовать требованиям LegacyRandomAccessIterator.
Функции-члены
std::boyer_moore_searcher::boyer_moore_searcher
boyer_moore_searcher( RandomIt1 pat_first,
RandomIt1 pat_last,
Hash hf = Hash(),
BinaryPredicate pred = BinaryPredicate() );
|
Создаёт std::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::boyer_moore_searcher::operator()
template< class RandomIt2 > std::pair<RandomIt2, RandomIt2> operator()( RandomIt2 first, RandomIt2 last ) const; | (начиная с C++17) |
Функция-член, вызываемая перегрузкой Searcher функции std::search для выполнения поиска с помощью этого средства поиска. RandomIt2 должен соответствовать требованиям LegacyRandomAccessIterator.
RandomIt1 и RandomIt2 должны иметь одинаковый тип значения.
Параметры
| first, last | - | пара итераторов, задающих строку, которую необходимо проверить |
Возвращаемое значение
Если шаблон [pat_first, pat_last) пуст, возвращает std::make_pair(first, first).
В противном случае возвращает пару итераторов, указывающих на первую и следующую за последней позиции в [first, last), где находится подпоследовательность, сравниваемая на равенство с [pat_first, pat_last) согласно определению pred, либо std::make_pair(last, last) в противном случае.
Примечания
| Макрос проверки поддержки функции | Значение | Стандарт | Возможность |
|---|---|---|---|
__cpp_lib_boyer_moore_searcher | 201603L | (C++17) | средства поиска |
Пример
#include <algorithm>
#include <functional>
#include <iomanip>
#include <iostream>
#include <string_view>
int main()
{
constexpr std::string_view haystack =
"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed "
"do eiusmod tempor incididunt ut labore et dolore magna aliqua";
const std::string_view needle{"pisci"};
if (const auto it = std::search(haystack.begin(), haystack.end(),
std::boyer_moore_searcher(needle.begin(), needle.end()));
it != haystack.end()
)
std::cout << "The string " << std::quoted(needle) << " found at offset "
<< it - haystack.begin() << '\n';
else
std::cout << "The string " << std::quoted(needle) << " not found\n";
}
Вывод:
The string "pisci" found at offset 43
См. также
| выполняет поиск первого вхождения диапазона элементов (шаблон функции и объект-функция алгоритма) |
|
|
(C++20) | |
|
(C++17) | стандартная реализация алгоритма поиска библиотеки C++ (шаблон класса) |
|
(C++17) | реализация алгоритма поиска Бойера — Мура — Хорспула (шаблон класса) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/utility/functional/boyer_moore_searcher