CKTIS / C++
std::basic_string::substr — subcadena con datos propios
Extrae un fragmento en una nueva cadena que posee sus datos. Aprende cómo se limita la longitud, cuándo falla la posición inicial y qué cambia con la sobrecarga para valores r en C++23.
Versión: ISO C++23; implementation support may vary
Sintaxis
// ISO C++23 — member declarations in std::basic_string (<string>)
constexpr basic_string substr(size_type pos = 0, size_type count = npos) const &;
constexpr basic_string substr(size_type pos = 0, size_type count = npos) &&;std::basic_string::substr es una función miembro declarada en <string>. s.substr(pos, count) devuelve una cadena nueva del mismo tipo que posee sus propios datos. pos es el índice inicial, a partir de cero; count es un número de elementos, no un índice final. Los valores predeterminados son 0 para pos y npos para count, que significa «hasta el final».
Si pos <= s.size(), el resultado contiene std::min(count, s.size() - pos) elementos. Si count es demasiado grande, se limita a los elementos disponibles. pos == s.size() o count == 0 con un pos válido produce una cadena vacía. pos > s.size() lanza std::out_of_range incluso si count == 0. Valida las entradas negativas antes de convertirlas al tipo sin signo size_type y comprueba la longitud antes de calcular s.size() - 4 para evitar que la resta se desborde por debajo de cero.
Antes de C++23 había una sola sobrecarga const, que era constexpr desde C++20. En C++23 ambas sobrecargas son constexpr; la compatibilidad puede variar según la biblioteca. const & copia el fragmento sin modificar el origen. && se selecciona para un valor r no constante, como std::move(s), y puede reutilizar la memoria del origen, pero no se garantiza que evite una asignación de memoria. Tras una llamada exitosa, el origen sigue siendo válido, pero su estado no está especificado. Ambas sobrecargas construyen por defecto el asignador del resultado, en vez de copiar s.get_allocator(). Si se lanza una excepción, el origen no cambia.
Las posiciones y longitudes cuentan elementos CharT: bytes en std::string y unidades de código UTF-8 de tipo char8_t en std::u8string. Un corte en UTF-8 puede partir un punto de código. substr conserva los elementos nulos internos; para copiar exactamente todo el intervalo, pasa s.data() y s.size() al constructor de la cadena, no solo el puntero. El resultado de std::basic_string_view::substr, en cambio, no posee los datos; úsalo solo mientras la memoria subyacente siga siendo válida.
Para letras y dígitos del juego de caracteres básico, s.substr(0, 3) toma hasta tres letras si están al principio, y s.substr(3) toma el resto si s.size() >= 3. substr extrae un intervalo, no filtra. Si la cadena ya contiene solo dígitos, usa digits.substr(digits.size() - 4) cuando tenga al menos cuatro elementos; si no, antepón los ceros de std::string(4 - digits.size(), '0').
Ejemplos
#include <iostream>
#include <stdexcept>
#include <string>
std::string last_four(const std::string& digits) {
if (digits.size() < 4) {
return std::string(4 - digits.size(), '0') + digits;
}
return digits.substr(digits.size() - 4);
}
int main() {
const std::string label = "ABC12345";
std::cout << label.substr(0, 3) << '\n';
std::cout << label.substr(3, 99) << '\n';
std::cout << last_four(label.substr(3)) << '\n';
std::cout << last_four("7") << '\n';
std::cout << '[' << label.substr(label.size()) << "]\n";
try {
(void)label.substr(label.size() + 1, 0);
} catch (const std::out_of_range&) {
std::cout << "out_of_range\n";
}
}Resultado
ABC 12345 2345 0007 [] out_of_range
El ejemplo muestra un prefijo, un límite aplicado al número de elementos, la conservación de los últimos cuatro dígitos o el relleno con ceros a la izquierda y la diferencia entre empezar al final y después del final.
Lecciones relacionadas
- C++ · Lección 49 · Avanzado · Versión: 3
- C++ · Lección 53 · Avanzado · Versión: 3