std::basic_string<CharT,Traits,Allocator>::contains
De es.cppreference.net
constexpr bool
contains( std::basic_string_view<CharT,Traits> sv ) const noexcept;
|
(1) | (desde C++23) |
constexpr bool
contains( CharT ch ) const noexcept;
|
(2) | (desde C++23) |
constexpr bool
contains( const CharT* s ) const;
|
(3) | (desde C++23) |
Comprueba si la cadena contiene la subcadena dada. La subcadena puede ser una de las siguientes:
1) Una vista de cadena
sv (que puede ser el resultado de una conversión implícita desde otro std::basic_string).2) Un solo carácter
ch.3) Una cadena de caracteres terminada en nulo
s.Las tres sobrecargas son equivalentes a return find(x) != npos;, donde x es el parámetro.
Parámetros
| sv | - |
una vista de cadena que puede ser el resultado de una conversión implícita de otro
std::basic_string
|
| ch | - | un carácter individual |
| s | - | una cadena de caracteres terminada en nulo |
Valor de retorno
true si la cadena contiene la subcadena proporcionada, false en caso contrario.
Notas
| Macro de prueba de características | Valor | Estándar | Característica |
|---|---|---|---|
__cpp_lib_string_contains
|
202011L
|
(C++23) |
contains
funciones
|
Ejemplo
Ejecutar este código
#include <iomanip> #include <iostream> #include <string> #include <string_view> #include <type_traits> template<typename SubstrType> void test_substring(const std::string& str, SubstrType subs) { constexpr char delim = std::is_scalar_v<SubstrType> ? '\'' : '\"'; std::cout << std::quoted(str) << (str.contains(subs) ? " contains " : " does not contain ") << std::quoted(std::string{subs}, delim) << '\n'; } int main() { using namespace std::literals; auto helloWorld = "hello world"s; test_substring(helloWorld, "hello"sv); test_substring(helloWorld, "goodbye"sv); test_substring(helloWorld, 'w'); test_substring(helloWorld, 'x'); }
Salida:
"hello world" contains "hello" "hello world" does not contain "goodbye" "hello world" contains 'w' "hello world" does not contain 'x'
Véase también
|
(C++20)
|
comprueba si la cadena comienza con el prefijo dado
(función miembro pública) |
|
(C++20)
|
comprueba si la cadena termina con el sufijo dado
(función miembro pública) |
|
encuentra la primera ocurrencia de la subcadena dada
(función miembro pública) |
|
|
devuelve una subcadena
(función miembro pública) |
|
|
(C++23)
|
comprueba si la vista de cadena contiene la subcadena o carácter dado
(función miembro pública de
std::basic_string_view<CharT,Traits>
)
|