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

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