Namensräume
Varianten
Aktionen

std::wmemcpy

Von cppreference.com
< cpp‎ | string‎ | wide
 
 
 
 
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

#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) [bearbeiten]
kopiert eine bestimmte Anzahl breiter Zeichen zwischen zwei, möglicherweise überlappenden, Arrays
(Funktion) [bearbeiten]
C-Dokumentation für wmemcpy