Namespaces
Variants

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

    From ja.cppreference.net
    C++
    Experimental
    Library fundamentals
    ヘッダーで定義 <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 ;
    		(ライブラリ基盤仕様 TS)

    std::experimental::search での使用に適したサーチャで、 Boyer-Moore-Horspool文字列検索アルゴリズム を実装しています。

    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でなければなりません。

    任意の2つの値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 ) 内で、 pred によって定義される方法で [ pat_first , pat_last ) と等しいと比較される部分列が位置する最初の位置へのイテレータ、または見つからない場合は last のコピーを返す。

    		(C++17まで)

    パターン [ pat_first , pat_last ) が空の場合、 make_pair ( first, first ) を返す。

    それ以外の場合、 [ first , last ) 内で、 pred によって定義される方法で [ pat_first , pat_last ) と等しいと比較される部分列が位置する最初と最後の次へのイテレータのペア、または見つからない場合は 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()
    );
    		(ライブラリ基礎 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

    関連項目

    		 範囲の要素の最初の出現を検索します
    （関数テンプレート&アルゴリズム関数オブジェクト）
    （C++20）