std::basic_string::find_first_of
De cppreference.com
< cpp | string | basic string
| (1) | ||
| size_type find_first_of( const basic_string& str, size_type pos = 0 ) const; |
(hasta C++11) | |
| size_type find_first_of( const basic_string& str, size_type pos = 0 ) const noexcept; |
(desde C++11) (hasta C++20) |
|
| constexpr size_type find_first_of( const basic_string& str, size_type pos = 0 ) const noexcept; |
(desde C++20) | |
| (2) | ||
| size_type find_first_of( const CharT* s, size_type pos, size_type count ) const; |
(hasta C++20) | |
| constexpr size_type find_first_of( const CharT* s, size_type pos, size_type count ) const; |
(desde C++20) | |
| (3) | ||
| size_type find_first_of( const CharT* s, size_type pos = 0 ) const; |
(hasta C++20) | |
| constexpr size_type find_first_of( const CharT* s, size_type pos = 0 ) const; |
(desde C++20) | |
| (4) | ||
| size_type find_first_of( CharT ch, size_type pos = 0 ) const; |
(hasta C++11) | |
| size_type find_first_of( CharT ch, size_type pos = 0 ) const noexcept; |
(desde C++11) (hasta C++20) |
|
| constexpr size_type find_first_of( CharT ch, size_type pos = 0 ) const noexcept; |
(desde C++20) | |
| (5) | ||
| template < class T > size_type |
(desde C++17) (hasta C++20) |
|
| template < class T > constexpr size_type |
(desde C++20) | |
Encuentra el primer carácter igual a uno de los caracteres en la secuencia de caracteres dada. La búsqueda considera solamente el intervalo [pos, size()). Si el carácter no está presente en el intervalo, se devuelve npos.
1) Encuentra el primer carácter igual a uno de los caracteres en
str.2) Encuentra el primer carácter igual a uno de los caracteres en el rango
[s, s+count). Este rango puede contener caracteres nulos.3) Encuentra el primer carácter igual a uno de los caracteres en la cadena de caracteres a la que apunta
s. La longitud de la cadena se determina por el primer carácter nulo usando Traits::length(s).4) Encuentra el primer carácter igual a
ch.5) Implícitamente convierte
t a una vista sobre cadena sv como si fuera mediante std::basic_string_view<CharT, Traits> sv = t;, entonces encuentra el primer carácter igual a uno de los caracteres en sv. Esta sobrecarga solo participa en la resolución de sobrecargas si std::is_convertible_v<const T&, std::basic_string_view<CharT, Traits>> es true y std::is_convertible_v<const T&, const CharT*> es false.En todos los casos, se comprueba la igualdad llamando a Traits::eq.
Contenido |
[editar] Parámetros
| str | - | La cadena que identifica los caracteres a buscar. |
| pos | - | La posición en la cual iniciar la búsqueda. |
| count | - | La longitud de la cadena de caracteres que identifica los caracteres a buscar. |
| s | - | Puntero a la cadena de caracteres que identifica los caracteres a buscar. |
| ch | - | Carácter a buscar. |
| t | - | Objeto (convertible a std::basic_string_view) que identifica los caracteres a buscar. |
[editar] Valor de retorno
Posición del primer carácter encontrado o npos si no se encontró dicho carácter.
[editar] Excepciones
5)
Especificación noexcept: (desde C++11)
| noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>) |
||
[editar] Ejemplo
Ejecuta este código
#include <iostream> #include <string> int main() { // la cadena de prueba std::string str = std::string("Hola mundo!"); // cadenas y caracteres a buscar std::string search_str = std::string("o"); const char* search_cstr = "Hasta luego!"; std::cout << str.find_first_of(search_str) << '\n'; std::cout << str.find_first_of(search_str, 5) << '\n'; std::cout << str.find_first_of(search_cstr) << '\n'; std::cout << str.find_first_of(search_cstr, 0, 4) << '\n'; // 'x' no se encuentra en "Hola mundo', se devolverá std::string::npos std::cout << str.find_first_of('x') << '\n'; }
Posible salida:
1 9 0 0 18446744073709551615
[editar] Informes de defectos
Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.
| ID | Aplicado a | Comportamiento según lo publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 2064 | C++11 | Las sobrecargas (3) y (4) eran noexcept | Se eliminó. |
| LWG 2946 | C++17 | La sobrecarga string_view causa ambigüedad en algunos casos.
|
Se evitó haciéndola una plantilla. |
| P1148R0 | C++11 C++17 |
noexcept para las sobrecargas (4)/(5) fue accidentalmente eliminado por LWG2064/LWG2946 | Se restauró. |
[editar] Véase también
| Encuentra caracteres en la cadena (función miembro pública) | |
| Encuentra la última aparición de una subcadena (función miembro pública) | |
| Encuentra la primera ausencia de caracteres (función miembro pública) | |
| Encuentra la última aparición de caracteres (función miembro pública) | |
| Encuentra la última ausencia de caracteres (función miembro pública) | |
| Devuelve la longitud del segmento inicial máximo que consiste de sólo los caracteres que se encuentran en otra cadena de bytes (función) |
