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

size_type copy( CharT* dest, size_type count, size_type pos = 0 ) const;

Copia una subcadena [pos, pos + count) a la cadena de caracteres apuntada por dest. Si la subcadena solicitada se extiende más allá del final de la cadena, o si count == npos, la subcadena copiada es [pos, size()).

La cadena de caracteres resultante no termina 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