char_traits::_Copy_s
Copia um número especificado de caracteres de uma cadeia de caracteres para outra.
static char_type *_Copy_s(
char_type *_Dest,
size_t _Dest_size,
const char_type *_From,
size_t _Count
);
Parâmetros
_Dest
Uma matriz de cadeia de caracteres ou de caractere de destino para receber a sequência copiada de caracteres._Dest_size
O tamanho de _Dest. Se char_type é char, esse tamanho é expresso em quilobytes. Se char_type é wchar_t, esse tamanho estiver no word._From
Uma matriz de cadeia de caracteres ou de caracteres de origem a ser copiada._Count
O número de elementos a serem copiados.
Valor de retorno
Uma matriz de cadeia de caracteres ou de caractere de destino para receber a sequência copiada de caracteres.
Comentários
As sequências de caracteres de origem e destino não devem se sobrepõem.
Exemplo
// char_traits__Copy_s.cpp
// compile with: /EHsc
#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;
result1 = char_traits<char>::_Copy_s(s1,
char_traits<char>::length(s1), s2, 4);
cout << "The result1 = _Copy_s(s1, "
<< "char_traits<char>::length(s1), s2, 4) is: "
<< result1 << endl;
}
Requisitos
Cabeçalho: <cadeia de caracteres>
Namespace: std