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,
|
||
Создает объект 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 ; |
(since 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++ (шаблон класса) |
| реализация алгоритма поиска Бойера — Мура — Хорспула (шаблон класса) |