std::basic_string<CharT,Traits,Allocator>:: copy

Copia una subcadena [ pos , pos + count ) a la cadena de caracteres apuntada por dest . Si la subcadena solicitada excede el final de la cadena, o si count == npos , la subcadena copiada es [ pos , size() ) .

La cadena de caracteres resultante no está terminada en nulo.

Parámetros

Valor de retorno

Número de caracteres copiados.

Excepciones

std::out_of_range si pos > size ( ) .

Si se lanza una excepción por cualquier razón, esta función no tiene efecto ( strong exception safety guarantee ).

Complejidad

Lineal en count .

Ejemplo

#include <iostream>
#include <string>
int main()
{
    std::string foo("WINE");
    // la inicialización con llaves inicializa todos los caracteres a 0,
    // proporcionando un terminador nulo
    char bar[4]{};
    // no copiar el último carácter, para garantizar la terminación nula
    foo.copy(bar, sizeof bar - 1);
    std::cout << bar << '\n'; // requiere que bar esté terminado en nulo
}

WIN

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares publicados anteriormente de C++.

Véase también