char_traits::copy

Copie un nombre spécifié de caractères d'une chaîne en un autre.

Cette méthode est potentiellement dangereuse, car elle repose sur l'appelant de vérifier que les valeurs passées sont correctes.Il vaut mieux utiliser char_traits::_Copy_s à la place.

static char_type *copy(
   char_type* _To, 
   const char_type* _From, 
   size_t _Num 
);

Paramètres

  • _To
    L'élément au début de la chaîne ou du tableau de caractères ciblé pour accepter la séquence copiée de caractères.

  • _From
    L'élément au début de la chaîne ou de la table de source à copier.

  • _Num
    Nombre d'éléments à copier.

Valeur de retour

Le premier élément copié dans la chaîne ou un tableau de caractères ciblé pour accepter la séquence copiée de caractères.

Notes

La source et les séquences de caractères de destination ne doivent pas se chevaucher.

Exemple

// char_traits_copy.cpp
// compile with: /EHsc /W3
#include <string>
#include <iostream>

int main( )
{
   using namespace std;

   char_traits<char>::char_type s1[] = "abcd-1234-abcd";
   char_traits<char>::char_type s2[] = "ABCD-1234";
   char_traits<char>::char_type* result1;
   cout << "The source string is: " << s1 << endl;
   cout << "The destination string is: " << s2 << endl;
   // Note: char_traits::copy is potentially unsafe, consider
   // using char_traits::_Copy_s instead.
   result1 = char_traits<char>::copy ( s1 , s2 , 4 );  // C4996
   cout << "The result1 = copy ( s1 , s2 , 4 ) is: "
        << result1 << endl;
}
  

Configuration requise

en-tête : <string>

l'espace de noms : DST

Voir aussi

Référence

char_traits Struct