Namespaces
Variants

std:: boyer_moore_searcher

From cppreference.net
C++
Utilities library
Function objects
Function invocation
(C++17) (C++23)
Identity function object
(C++20)
Old binders and adaptors
( until C++17* )
( until C++17* )
( until C++17* )
( until C++17* )
( until C++17* )
( until C++17* )
( until C++17* ) ( until C++17* ) ( until C++17* ) ( until C++17* )
( until C++20* )
( until C++20* )
( until C++17* ) ( until C++17* )
( until C++17* ) ( until C++17* )

( until C++17* )
( until C++17* ) ( until C++17* ) ( until C++17* ) ( until C++17* )
( until C++20* )
( until C++20* )
Definido en el encabezado <functional>
template < class RandomIt1,

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

class boyer_moore_searcher ;
(desde C++17)

Un buscador adecuado para usar con la sobrecarga Searcher de std::search que implementa el algoritmo de búsqueda de cadenas Boyer-Moore .

std::boyer_moore_searcher es CopyConstructible y CopyAssignable .

RandomIt1 debe cumplir con los requisitos de LegacyRandomAccessIterator .

Contenidos

Funciones miembro

std::boyer_moore_searcher:: boyer_moore_searcher

boyer_moore_searcher ( RandomIt1 pat_first,

RandomIt1 pat_last,
Hash hf = Hash ( ) ,

BinaryPredicate pred = BinaryPredicate ( ) ) ;

Construye un std::boyer_moore_searcher almacenando copias de pat_first , pat_last , hf , y pred , configurando cualquier estructura de datos interna necesaria.

El tipo de valor de RandomIt1 debe ser DefaultConstructible , CopyConstructible y CopyAssignable .

Para cualesquiera dos valores A y B del tipo std:: iterator_traits < RandomIt1 > :: value_type , si pred ( A, B ) == true , entonces hf ( A ) == hf ( B ) debe ser true .

Parámetros

pat_first, pat_last - un par de iteradores que designan la cadena a buscar
hf - un objeto invocable utilizado para aplicar hash a los elementos de la cadena
pred - un objeto invocable utilizado para determinar igualdad

Excepciones

Cualquier excepción lanzada por

  • el constructor de copia de RandomIt1 ;
  • el constructor por defecto, constructor de copia y operador de asignación de copia del tipo de valor de RandomIt1 ; o
  • el constructor de copia y operador de llamada a función de BinaryPredicate o Hash .

También puede lanzar std::bad_alloc si no se puede asignar la memoria adicional requerida para las estructuras de datos internas.

std::boyer_moore_searcher:: operator()

template < class RandomIt2 >
std:: pair < RandomIt2, RandomIt2 > operator ( ) ( RandomIt2 first, RandomIt2 last ) const ;
(desde C++17)

La función miembro llamada por la sobrecarga Searcher de std::search para realizar una búsqueda con este buscador. RandomIt2 debe cumplir con los requisitos de LegacyRandomAccessIterator .

RandomIt1 y RandomIt2 deben tener el mismo tipo de valor.

Parámetros

first, last - un par de iteradores que designan la cadena a examinar

Valor de retorno

Si el patrón [ pat_first , pat_last ) está vacío, retorna std:: make_pair ( first, first ) .

De lo contrario, retorna un par de iteradores a las posiciones inicial y final en [ first , last ) donde se localiza una subsecuencia que compara igual a [ pat_first , pat_last ) según lo definido por pred , o std:: make_pair ( last, last ) en caso contrario.

Notas

Macro de prueba de características Valor Estándar Característica
__cpp_lib_boyer_moore_searcher 201603L (C++17) buscadores

Ejemplo

Ejecutar este código 
#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";
}

Salida: 

The string "pisci" found at offset 43

Véase también

busca la primera ocurrencia de un rango de elementos
(plantilla de función)
(C++17)
implementación del algoritmo de búsqueda estándar de la biblioteca C++
(plantilla de clase)
(C++17)
implementación del algoritmo de búsqueda Boyer-Moore-Horspool
(plantilla de clase)