std::wmemcpy
From cppreference.com
| ヘッダ <cwchar> で定義 |
||
| wchar_t* wmemcpy( wchar_t* dest, const wchar_t* src, std::size_t count ); |
||
count 個の連続するワイド文字を、src が指すワイド文字列配列から、dest が指すワイド文字列配列へコピーします。オブジェクトが重複する場合、動作は未定義です。count が 0 の場合、関数は何も行いません。
目次 |
[編集] パラメータ
| dest | - | コピー先のワイド文字配列へのポインタ |
| src | - | コピー元のワイド文字配列へのポインタ |
| count | - | コピーするワイド文字の数 |
[編集] 戻り値
dest
[編集] 注記
バイト文字列に対するこの関数の類似は、std::strcpy ではなく、std::strncpy です。
この関数はロケールに依存せず、コピーする wchar_t オブジェクトの値には注意しません。ヌル文字や無効な文字もコピーされます。
[編集] 例
このコードを実行
#include <clocale> #include <cwchar> #include <iostream> #include <iterator> #include <locale> int main(void) { const wchar_t from1[] = L"नमस्ते"; const wchar_t from2[] = L"Բարև"; const std::size_t sz1 = std::size(from1); const std::size_t sz2 = std::size(from2); wchar_t to[sz1 + sz2]; std::wmemcpy(to, from1, sz1); // copy from1, along with its null terminator std::wmemcpy(to + sz1, from2, sz2); // append from2, along with its null terminator std::setlocale(LC_ALL, "en_US.utf8"); std::wcout.imbue(std::locale("en_US.utf8")); std::wcout << L"Wide array contains: "; for (std::size_t n = 0; n < std::size(to); ++n) if (to[n]) std::wcout << to[n]; else std::wcout << L"\\0"; std::wcout << L'\n'; }
実行結果の例
Wide array contains: नमस्ते\0Բարև\0
[編集] 関連項目
| ある文字列から別の文字列に指定された文字数をコピーする (関数) | |
| オーバーラップしている可能性のある2つの配列間で、指定された数のワイド文字をコピーする (関数) | |
| Cドキュメント (wmemcpy について)
| |