std::basic_string::substr - cppreference.com

De cppreference.com

`basic_string substr( size_type pos = 0, size_type count = npos ) const;`	(1)	(hasta C++23) (constexpr desde C++20)
`constexpr basic_string substr( size_type pos = 0, size_type count = npos ) const&;`		(desde C++23)
`constexpr basic_string substr( size_type pos = 0, size_type count = npos ) &&;`	(2)	(desde C++23)

Devuelve una subcadena [pos, pos+count). Si la subcadena solicitado se extiende más allá del final de la cadena, o si count == npos, la subcadena devuelta es [pos, size()).

Parámetros

pos	-	Posición del primer carácter a incluir.
count	-	Longitud de la subcadena.

Valor de retorno

Cadena que contiene la subcadena [pos, pos+count).

Excepciones

std::out_of_range si pos > size().

Complejidad

Lineal en count.

Notas

La cadena devuelta se construye como si fuera mediante basic_string(data()+pos, count), lo que implica que el asignador de memoria de la cadena será construido por defecto—el nuevo asignador no será una copia de
this->get_allocator().

Ejemplo

#include <string>
#include <iostream>
 
int main()
{
    std::string a = "0123456789abcdefghij";

    // pos y count se refieren al nombre de los parámetros,
    // npos al dato miembro estático
 
    // count es npos, devuelve [pos, size())
    std::string sub1 = a.substr(10);
    std::cout << sub1 << '\n';
 
    // tanto  pos como pos+count están dentro de los límites, devuelve [pos, pos+count)
    std::string sub2 = a.substr(5, 3);
    std::cout << sub2 << '\n';

    // pos está dentro de los límites, pos+count no, devuelve [pos, size()) 
    std::string sub4 = a.substr(a.size()-3, 50);
    std::cout << sub4 << '\n';

    try {
        // pos está fuera de los límites, lanza
        std::string sub5 = a.substr(a.size()+3, 50);
        std::cout << sub5 << '\n';
    } catch(const std::out_of_range& e) {
        std::cout << "pos se excede\n"; // excede el tamaño de la cadena
    }
}

Salida:

abcdefghij
567
hij
pos se excede

Véase también

	Copia caracteres (función miembro pública) [editar]
	Devuelve el número de caracteres (función miembro pública) [editar]
	Encuentra caracteres en la cadena (función miembro pública) [editar]
	Valor especial. El significado exacto depende del contexto (constante miembro pública estática) [editar]