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

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

Copie une sous-chaîne [pos, pos + count) vers la chaîne de caractères pointée par dest. Si la sous-chaîne demandée dépasse la fin de la chaîne, ou si count == npos, la sous-chaîne copiée est [pos, size()).

La chaîne de caractères résultante n'est pas terminée par un caractère nul.

Paramètres

Valeur de retour

Nombre de caractères copiés.

Exceptions

std::out_of_range si pos > size ( ) .

Si une exception est levée pour quelque raison que ce soit, cette fonction n'a aucun effet ( strong exception safety guarantee ).

Complexité

Linéaire en count .

Exemple

#include <iostream>
#include <string>
int main()
{
    std::string foo("WINE");
    // l'initialisation par accolades initialise tous les caractères à 0,
    // fournissant un terminateur nul
    char bar[4]{};
    // ne pas copier le dernier caractère, pour garantir la null-termination
    foo.copy(bar, sizeof bar - 1);
    std::cout << bar << '\n'; // nécessite que bar soit null-terminated
}

WIN

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi