Export (0) Print
Expand All

char_traits::_Copy_s

Copies a specified number of characters from one string to another.

static char_type *_Copy_s(
    char_type *_Dest,
    size_t _Dest_size,
    const char_type *_From,
    size_t _Count
);

_Dest

The string or character array targeted to receive the copied sequence of characters.

_Dest_size

The size of _Dest. If char_type is char, then this size is in bytes. If char_type is wchar_t, then this size is in words.

_From

The source string or character array to be copied.

_Count

The number of elements to be copied.

The string or character array targeted to receive the copied sequence of characters.

The source and destination character sequences must not overlap.

// 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;
}
The source string is: abcd-1234-abcd
The destination string is: ABCD-1234
The result1 = _Copy_s(s1, char_traits<char>::length(s1), s2, 4) is: ABCD-1234-abcd

Header: <string>

Namespace: std

Show:
© 2014 Microsoft