std::basic_string::find_first_not_of
De cppreference.com
< cpp | string | basic string
| (1) | ||
| size_type find_first_not_of( const basic_string& str, size_type pos = 0 ) const; |
(hasta C++11) | |
| size_type find_first_not_of( const basic_string& str, size_type pos = 0 ) const noexcept; |
(desde C++11) (hasta C++20) |
|
| constexpr size_type find_first_not_of( const basic_string& str, size_type pos = 0 ) const noexcept; |
(desde C++20) | |
| (2) | ||
| size_type find_first_not_of( const CharT* s, size_type pos, size_type count ) const; |
(hasta C++20) | |
| constexpr size_type find_first_not_of( const CharT* s, size_type pos, size_type count ) const; |
(desde C++20) | |
| (3) | ||
| size_type find_first_not_of( const CharT* s, size_type pos = 0 ) const; |
(hasta C++20) | |
| constexpr size_type find_first_not_of( const CharT* s, size_type pos = 0 ) const; |
(desde C++20) | |
| (4) | ||
| size_type find_first_not_of( CharT ch, size_type pos = 0 ) const; |
(hasta C++11) | |
| size_type find_first_not_of( CharT ch, size_type pos = 0 ) const noexcept; |
(desde C++11) (hasta C++20) |
|
| constexpr size_type find_first_not_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 que no es igual a ninguno 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 que no es igual a ninguno de los caracteres en
str. 2) Encuentra el primer carácter que no es igual a ninguno de los caracteres en el rango
[s, s+count). Este rango puede contener caracteres nulos.3) Encuentra el primer carácter que no es igual a ninguno 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 que no es 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 que no es igual a ninguno 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 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 <string> #include <iostream> int main() { std::string to_search = "Algunos datos con %MACROS a sustituir"; std::cout << "Antes: " << to_search << '\n'; auto pos = std::string::npos; while ((pos = to_search.find('%')) != std::string::npos) { // Permitir letras mayúsculas, minúsculas y números en los nombres de las macros const auto after = to_search.find_first_not_of("ABCDEFGHIJKLMNOPQRSTUVWXYZ" "abcdefghijklmnopqrstuvwxyz" "0123456789", pos + 1); // Ahora to_search[pos] == '%' y to_search[after] == ' ' (después de 'S') if(after != std::string::npos) to_search.replace(pos, after - pos, "algunas macros muy agradables"); } std::cout << "Despues: " << to_search << '\n'; }
Salida:
Antes: Algunos datos con %MACROS a sustituir Despues: Algunos datos con algunas macros muy agradables a sustituir
[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 aparición 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) |
