Compartilhar via


char_traits::copy

Copia um número especificado de caracteres de uma cadeia de caracteres para outra.

Este método é potencialmente perigosos, porque depende do chamador para verificar se os valores passados estão corretos.Considere usar char_traits::_Copy_s em vez de isso.

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

Parâmetros

  • _To
    O elemento no início da matriz de cadeias de caracteres ou caractere de destino para receber cópias a seqüência de caracteres.

  • _From
    O elemento no início da matriz de cadeias de caracteres ou de caractere fonte a ser copiado.

  • _Num
    O número de elementos a serem copiados.

Valor de retorno

O primeiro elemento copiou na matriz de cadeias de caracteres ou caractere de destino para receber cópias a seqüência de caracteres.

Comentários

As seqüências de caracteres de origem e de destino não devem sobrepostos.

Exemplo

// 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;
}
  

Requisitos

Cabeçalho: <string>

namespace: STD

Consulte também

Referência

char_traits Struct