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
    A matriz de cadeias de caracteres ou caractere de destino para receber cópias a seqüência de caracteres.

  • _Dest_size
    o tamanho de _Dest.Se char_type é char, então este é tamanho em bytes.Se char_type é wchar_t, então esse tamanho está em palavras.

  • _From
    A matriz de cadeias de caracteres ou de caractere fonte a ser copiado.

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

Valor de retorno

A 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_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: <string>

namespace: STD

Consulte também

Referência

char_traits Struct

Bibliotecas de seguras: Biblioteca C++ padrão