std::wmemcpy
Von cppreference.com
| Definiert in Header <cwchar> |
||
| wchar_t* wmemcpy( wchar_t* dest, const wchar_t* src, std::size_t count ); |
||
Kopiert exakt count aufeinanderfolgende Weitzeichen aus dem von src zeigenden Weitzeichen-Array in das von dest zeigende Weitzeichen-Array. Wenn sich die Objekte überlappen, ist das Verhalten undefiniert. Wenn count null ist, tut die Funktion nichts.
Inhalt |
[bearbeiten] Parameter
| dest | - | Zeiger auf das Wide-Zeichen-Array, in das kopiert werden soll |
| src | - | Zeiger auf das Wide-Zeichen-Array, aus dem kopiert werden soll |
| zählt | - | Anzahl der zu kopierenden Wide-Zeichen |
[bearbeiten] Rückgabewert
dest
[bearbeiten] Hinweise
Das Analogon dieser Funktion für Byte-Strings ist std::strncpy, nicht std::strcpy.
Diese Funktion ist nicht gebietsschema-sensitiv und beachtet die Werte der wchar_t-Objekte, die sie kopiert, nicht: Null-Zeichen sowie ungültige Zeichen werden ebenfalls kopiert.
[bearbeiten] Beispiel
Führen Sie diesen Code aus
#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'; }
Mögliche Ausgabe
Wide array contains: नमस्ते\0Բարև\0
[bearbeiten] Siehe auch
| kopiert eine bestimmte Anzahl von Zeichen von einem String in einen anderen (Funktion) | |
| kopiert eine bestimmte Anzahl breiter Zeichen zwischen zwei, möglicherweise überlappenden, Arrays (Funktion) | |
| C-Dokumentation für wmemcpy
| |