Namespaces
Variants

wmemcpy, wmemcpy_s

ja.cppreference.net より
 
 
 
 
ヘッダ <wchar.h>
wchar_t* wmemcpy( wchar_t* dest, const wchar_t* src, size_t count );
で定義 (1) (C95 以降)
(C99 まで)
wchar_t* wmemcpy(wchar_t* restrict dest, const wchar_t* restrict src,
                 size_t count );
(C99 以降)
errno_t wmemcpy_s( wchar_t* restrict dest, rsize_t destsz,
                   const wchar_t* restrict src, rsize_t count );
(2) (C11 以降)
1) ちょうど count 個の連続したワイド文字を、src が指すワイド文字配列から、dest が指すワイド文字配列にコピーする。オブジェクトが重なっている場合、動作は未定義である。count がゼロの場合、関数は何もしない。
2) (1) と同じ。ただし、以下のエラーが実行時に検出され、現在インストールされている 制約ハンドラ 関数を呼び出す点が異なる:
  • src または dest がNULLポインタである
  • destsz または count が RSIZE_MAX / sizeof(wchar_t)
  • count より大きいdestsz (オーバーフローが発生する)
  • コピー元とコピー先の配列の間で重なりが発生する
すべての境界チェック関数と同様に、wmemcpy_s は、__STDC_LIB_EXT1__ が実装によって定義され、ユーザーが __STDC_WANT_LIB_EXT1__ を整数定数 1 に定義してから <wchar.h> をインクルードする場合にのみ利用可能であることが保証される。

引数

dest - コピー先のワイド文字配列へのポインタ
src - コピー元のワイド文字配列へのポインタ
count - コピーするワイド文字数
destsz - 書き込むワイド文字の最大数 (コピー先バッファのサイズ)

戻り値

1) dest
のコピーを返す。2)dest は成功時にゼロを返し、エラー時には非ゼロを返す。また、エラー時には、dest + destsz まで (ただし L'\0' は含まない) をヌルワイド文字で埋める。dest (ただし、destsz がNULLであるか、RSIZE_MAX / sizeof(wchar_t) より大きい場合は除く。)

ノート

この関数のバイト文字列版は strncpy であり、strcpy ではない。

この関数はロケールに依存せず、コピーする wchar_t オブジェクトの値に注意を払わない:NULL文字だけでなく無効な文字もコピーされる。

例

#include <locale.h>
#include <stdio.h>
#include <wchar.h>

int main(void)
{
    wchar_t from1[] = L"नमस्ते";
    size_t sz1 = sizeof from1 / sizeof *from1;
    wchar_t from2[] = L"Բարև";
    size_t sz2 = sizeof from2 / sizeof *from2;
    wchar_t to[sz1 + sz2];
    wmemcpy(to, from1, sz1); // copy from1, along with its null terminator
    wmemcpy(to + sz1, from2, sz2); // append from2, along with its null terminator

    setlocale(LC_ALL, "en_US.utf8");
    printf("Wide array contains: ");
    for(size_t n = 0; n < sizeof to / sizeof *to; ++n)
        if(to[n])
            printf("%lc", to[n]);
        else
            printf("\\0");
    printf("\n");
}

出力例:

Wide array contains: नमस्ते\0Բարև\0

参考文献

  • C23 標準 (ISO/IEC 9899:2024):
  • 7.29.4.2.3 The wmemcpy function (p: TBD)
  • K.3.9.2.1.3 The wmemcpy_s function (p: TBD)
  • C17 標準 (ISO/IEC 9899:2018):
  • 7.29.4.2.3 The wmemcpy function (p: TBD)
  • K.3.9.2.1.3 The wmemcpy_s function (p: TBD)
  • C11 標準 (ISO/IEC 9899:2011):
  • 7.29.4.2.3 The wmemcpy function (p: 431)
  • K.3.9.2.1.3 The wmemcpy_s function (p: 641)
  • C99 標準 (ISO/IEC 9899:1999):
  • 7.24.4.2.3 The wmemcpy function (p: 377)

関連項目

2つの (場合によっては重なった) 配列間で一定量のワイド文字をコピーする
(関数)
一方の文字列から他方へ一定量の文字をコピーする
(関数)