CKTIS / C++
std::string::find — primeira ocorrência e npos
Encontra o índice de um carácter ou de uma subcadeia e compara-o com `std::string::npos` antes de o usar como índice ou de copiar ou alterar o texto.
Versão: ISO C++23; implementation support may vary
Sintaxe
// C++23 member declarations, with types written for std::string (<string>).
// The template participates only if const T& is implicitly convertible to
// std::string_view but not to const char*.
constexpr size_type find(char ch, size_type pos = 0) const noexcept;
constexpr size_type find(const std::string& needle, size_type pos = 0) const noexcept;
constexpr size_type find(const char* needle, size_type pos = 0) const;
constexpr size_type find(const char* needle, size_type pos, size_type count) const;
template<class T>
constexpr size_type find(const T& needle, size_type pos = 0) const
noexcept(std::is_nothrow_convertible_v<const T&, std::string_view>);
static constexpr size_type npos = size_type(-1);std::string::find é uma função membro const de std::string, do cabeçalho <string>. Devolve o menor índice de uma ocorrência que comece em pos (por omissão 0) ou depois, contando a partir de zero. O padrão tem de caber por inteiro no texto. Um padrão vazio corresponde em pos se pos <= s.size(); um padrão não vazio não pode corresponder se pos >= s.size(). A pesquisa distingue maiúsculas de minúsculas e os índices contam elementos char, não pontos de código Unicode.
O resultado é do tipo std::string::size_type. A ausência de uma ocorrência não lança uma exceção: o resultado é std::string::npos, o maior valor desse tipo sem sinal. Testa i != std::string::npos antes de usares o índice ou de fazeres cálculos com ele. if (i) é falso para uma ocorrência válida em 0 e verdadeiro para npos. O resultado é um número, não um iterador nem uma vista, e pode deixar de identificar a mesma ocorrência depois de o texto mudar.
Usa s.find('!') para procurar um carácter. Para uma subcadeia, passa um std::string, um std::string_view ou uma cadeia válida terminada pelo carácter nulo, como em s.find("ab"). Em s.find(ptr, pos, count), count é o comprimento do padrão, não um limite da pesquisa; o padrão pode incluir \0. Qualquer ponteiro ou vista fornecido tem de referenciar dados válidos durante toda a chamada. Um intervalo inválido não devolve npos: causa comportamento indefinido.
As sobrecargas para char e std::string são noexcept; as que recebem ponteiros não são declaradas noexcept. A sobrecarga de modelo, disponível desde C++17, aceita tipos implicitamente convertíveis em std::string_view mas não em const char*; o seu noexcept depende da conversão para a vista. Todas as sobrecargas são constexpr desde C++20. Se só precisares de um sim ou não e não precisares de indicar uma posição inicial, s.contains('!') é uma alternativa de C++23 se a biblioteca a suportar.
Se s já for um std::string, testa s.find('!') != std::string::npos antes de criares uma cópia de trabalho ou alterares o texto. A pesquisa em si não copia nem altera s. Este teste rejeita !, mas não substitui outras regras de validação.
Exemplos
#include <iostream>
#include <string>
void process(const std::string& input) {
const auto bad = input.find('!');
if (bad != std::string::npos) {
std::cout << "rejected at " << bad << '\n';
return;
}
auto result = input;
result += '.';
std::cout << "accepted: " << result << '\n';
}
int main() {
const std::string invalid = "!abc";
const std::string valid = "abc";
process(invalid);
process(valid);
}Resultado
rejected at 0 accepted: abc.
Em `!abc`, `!` está no índice `0`, pelo que a função termina antes de fazer uma cópia. Em `abc`, não há ocorrência e só então a função cria uma cópia e acrescenta-lhe um ponto final.
Lições relacionadas
- C++ · Lição 15 · Avançado · Versão: 3