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
- 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