char_traits::copy

1 文字列から別の場所に指定した数の文字をコピーします。

このメソッドは、呼び出し元に渡された値が正しいことを確認するために依存するため、場合によっては安全ではありません。代わりに、char_traits::_Copy_s を使用することを検討してください。

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

パラメーター

• _To
  文字シーケンスのコピーを受信する対象となる文字列または文字配列の先頭の要素。

• _From
  コピー元の文字列または文字配列の先頭の要素。

• _Num
  コピーする要素の数。

戻り値

文字シーケンスのコピーを受信する対象となる文字列または文字配列にコピー最初の要素。

解説

コピー元とコピー先の文字シーケンスが重なり合うことはできません。

使用例

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

必要条件

ヘッダー: <string>

名前空間: std

参照

関連項目

char_traits Struct