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)constnoexcept; | (desde C++11) (hasta C++20) | |
constexpr size_type find_first_not_of(const basic_string& str, size_type pos =0)constnoexcept; | (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)constnoexcept; | (desde C++11) (hasta C++20) | |
constexpr size_type find_first_not_of( CharT ch, size_type pos =0)constnoexcept; | (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 macrosconstauto 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) |