std::basic_string::substr
De cppreference.com
< cpp | string | basic string
| basic_string substr( size_type pos = 0, size_type count = npos ) const; |
(hasta C++20) | |
| constexpr basic_string substr( size_type pos = 0, size_type count = npos ) const; |
(desde C++20) | |
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()).
Contenido |
[editar] Parámetros
| pos | - | Posición del primer carácter a incluir. |
| count | - | Longitud de la subcadena. |
[editar] Valor de retorno
Cadena que contiene la subcadena [pos, pos+count).
[editar] Excepciones
std::out_of_range si pos > size().
[editar] Complejidad
Lineal en count.
[editar] 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 dethis->get_allocator().
[editar] Ejemplo
Ejecuta este código
#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
[editar] Véase también
| Copia caracteres (función miembro pública) | |
| Devuelve el número de caracteres (función miembro pública) | |
| Encuentra caracteres en la cadena (función miembro pública) | |
| [estático] |
Valor especial. El significado exacto depende del contexto (constante miembro pública estática) |
