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

CKTIS / C++

`std::string::npos`: sem correspondência ou contagem até ao fim

Compara o resultado de `std::string::find` com `std::string::npos`. Como número de caracteres em `substr` ou `erase`, a mesma constante significa «até ao fim», não uma posição inicial.

Versão: ISO C++23; implementation support may vary

Sintaxe

#include <string>

// Declaration inside std::basic_string in C++23:
// static constexpr size_type npos = size_type(-1);

// For an existing std::string s:
// const auto pos = s.find('#');
// pos == std::string::npos  // no match
// pos != std::string::npos  // match found
// s.substr(0, std::string::npos)  // npos is a count here

Em C++23, std::string::npos é um membro static constexpr do tipo std::string::size_type, disponível através de <string>. Converter -1 para este tipo sem sinal dá o seu maior valor representável. Não é um índice negativo: não assumas uma largura do tipo nem um valor decimal específicos.

input.find('#') seleciona a sobrecarga para um único carácter. Por omissão, pesquisa a partir do índice 0 e devolve o índice da primeira correspondência ou std::string::npos se não encontrar nenhuma. Guarda o resultado com auto ou std::string::size_type: pos == std::string::npos indica que não houve correspondência e pos != std::string::npos que houve. Não uses if (pos): o índice válido 0 dá false, enquanto npos dá true.

O significado depende do argumento. s.substr(start, std::string::npos) devolve uma cadeia separada desde start até ao fim; s.erase(start, std::string::npos) remove essa parte de s. Em ambas as chamadas, start não pode ser maior do que s.size(); caso contrário, a função lança std::out_of_range. Confirma que houve correspondência antes de usar o resultado como índice ou posição inicial ou de fazer cálculos com ele.

Exemplos

#include <iostream>
#include <string>

void process(const std::string& input)
{
    const auto pos = input.find('#');
    if (pos != std::string::npos) {
        std::cout << "Rejected at index " << pos << '\n';
        return;
    }

    std::string result = input;
    result += '!';
    std::cout << "Accepted: " << result << '\n';
}

int main()
{
    const std::string invalid = "#draft";
    const std::string valid = "draft";
    process(invalid);
    process(valid);
}

Resultado

Rejected at index 0
Accepted: draft!

Em `#draft`, `#` está no índice `0`, pelo que a função rejeita a entrada antes de copiar o seu conteúdo ou alterar uma cadeia. Em `draft` não há `#`: a função copia a entrada e acrescenta `!` à cópia, deixando a entrada intacta.

Lições relacionadas

  • C++ · Lição 15 · Avançado · Versão: 3

Fontes