Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::basic_string::npos — sin coincidencia o hasta el final

Compara el resultado de `find` con `npos` antes de usarlo como índice. Como cantidad en `substr`, esa misma constante indica que se toma el resto de la cadena.

Versión: ISO C++23; implementation support may vary

Sintaxis

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 es un miembro estático constexpr declarado en <string>. El inicializador size_type(-1) convierte -1 en el mayor valor del tipo sin signo size_type de la especialización. No es un número negativo ni la longitud actual size(). Para std::string, escribe std::string::npos.

find devuelve el índice de la primera coincidencia, contando desde cero, o npos si no hay ninguna. Guarda el resultado con auto o size_type, no con int, y compáralo con npos antes de usarlo como índice o calcular pos + 1. Si el separador es obligatorio, rechaza el registro cuando falte. En cambio, el valor predeterminado pos = npos de rfind no impone un límite superior a la posición de la coincidencia; como valor devuelto, npos sigue indicando que no hubo coincidencia.

En substr(pos, count), el valor predeterminado count = npos significa «desde pos hasta el final». Una cantidad excesiva se limita a size() - pos, pero pos > size() lanza std::out_of_range; con pos == size() se obtiene una cadena vacía. En C++23, las dos sobrecargas de substr, const & y &&, devuelven una cadena que posee sus datos, no una vista.

«Hasta el final» también se aplica a append(src, pos, n) y assign(src, pos, n) cuando el origen es un basic_string. En cambio, append(ptr, n) y assign(ptr, n) requieren una cantidad real de elementos accesibles a través del puntero. No pases npos como longitud de un búfer. Si pasas data() y size() a una interfaz que recibe un puntero y una longitud, comprueba sus requisitos de rango y de vida útil de los datos.

Ejemplos

#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 '='

Del primer registro se extraen la clave `mode` y el valor `fast`, que se imprimen separados por dos puntos. En el segundo falta `=`, así que el programa indica el error antes de calcular dónde empieza el valor.

Lecciones relacionadas

  • C++ · Lección 58 · Avanzado · Versión: 3

Fuentes