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

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