CKTIS / C++
std::basic_string::npos — sem correspondência ou até ao fim
Compara o resultado de `find` com `npos` antes de o usares como índice. No parâmetro de contagem de `substr`, a mesma constante indica o resto da cadeia.
Versão: ISO C++23; implementation support may vary
Sintaxe
static constexpr size_type npos = size_type(-1); // member of std::basic_string in <string>
std::basic_string<CharT, Traits, Allocator>::npos
std::string::npos // for std::basic_string<char>std::basic_string::npos é um membro estático constexpr declarado em <string>. O inicializador size_type(-1) converte -1 no maior valor do tipo sem sinal size_type da especialização. Não é um número negativo nem o comprimento atual size(). Para std::string, escreve std::string::npos.
find devolve o índice da primeira correspondência, contando a partir de zero, ou npos se não houver nenhuma. Guarda o resultado com auto ou size_type, não com int, e compara-o com npos antes de o usares como índice ou de calculares pos + 1. Se o separador for obrigatório, rejeita o registo quando faltar. Em rfind, pelo contrário, o valor predefinido pos = npos não impõe um limite superior à posição da correspondência; como valor devolvido, npos continua a indicar que não houve correspondência.
Em substr(pos, count), o valor predefinido count = npos significa «de pos até ao fim». Uma contagem excessiva é limitada a size() - pos, mas pos > size() lança std::out_of_range; pos == size() dá uma cadeia vazia. Em C++23, as duas sobrecargas de substr, const & e &&, devolvem uma cadeia que possui os seus próprios dados, não uma vista.
«Até ao fim» também se aplica a append(src, pos, n) e assign(src, pos, n) quando a origem é um basic_string. Já append(ptr, n) e assign(ptr, n) exigem uma contagem real de elementos acessíveis através do ponteiro. Não passes npos como comprimento de um buffer. Ao forneceres data() e size() a uma interface que recebe um ponteiro e um comprimento, verifica os requisitos quanto ao intervalo e ao tempo de vida dos dados.
Exemplos
#include <iostream>
#include <string>
int main() {
const std::string records[] = {"mode=fast", "mode"};
for (const auto& record : records) {
const auto sep = record.find('=');
if (sep == std::string::npos) {
std::cout << "missing '='\n";
continue;
}
const auto key = record.substr(0, sep);
const auto value = record.substr(sep + 1, std::string::npos);
std::cout << key << ": " << value << '\n';
}
}
Resultado
mode: fast missing '='
O primeiro registo é dividido na chave `mode` e no valor `fast`, apresentados com dois pontos entre eles. No segundo falta `=`, pelo que o programa indica o erro antes de calcular a posição inicial do valor.
Lições relacionadas
- C++ · Lição 58 · Avançado · Versão: 3
Fontes
- N4950 — Working Draft, Programming Languages — C++ (C++23)
- [basic.string] Class template basic_string
- [conv.integral] Integral conversions
- [string.find] basic_string searching
- [string.view.find] basic_string_view searching
- [string.substr] basic_string::substr
- [string.cons] basic_string constructors and assignment operators
- [string.append] basic_string::append
- [string.assign] basic_string::assign