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 hereEm 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
- C++23 working draft N4950 — [basic.string], [string.find], [string.view.find], [string.substr], [string.cons], [string.erase], [conv.integral]
- [basic.string] — Class template basic_string
- [string.find] — basic_string searching
- [string.view.find] — basic_string_view searching
- [string.substr] — basic_string::substr
- [string.erase] — basic_string::erase