Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes