wcsncpy, wcsncpy_s

wchar_t* wcsncpy( wchar_t* dest, const wchar_t* src, size_t count );

wchar_t* wcsncpy( wchar_t* restrict dest, const wchar_t* restrict src, size_t count );

errno_t wcsncpy_s( wchar_t* restrict dest, rsize_t destsz,
                   const wchar_t* restrict src, rsize_t count);

Parameter

Rückgabewert

Anmerkungen

Bei typischer Verwendung ist count die Anzahl der Elemente im Ziel-Array.

Obwohl das Abschneiden, um in den Zielpuffer zu passen, ein Sicherheitsrisiko und daher eine Laufzeiteinschränkungsverletzung für wcsncpy_s darstellt, ist es möglich, das abschneidende Verhalten zu erreichen, indem man count gleich der Größe des Ziel-Arrays minus eins setzt: Es werden die ersten count Breitzeichen kopiert und wie immer das abschließende Null-Breitzeichen angehängt:

size_t count = sizeof dst / sizeof *dst;
wcsncpy_s(dst, count, src, count - 1);

Beispiel

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    const wchar_t src[] = L"わゐ";
    wchar_t dest[6] = {L'あ', L'い', L'う', L'え', L'お'};
 
    wcsncpy(dest, src, 4); // this will copy わゐ and repeat L'\0' two times
 
    puts("The contents of dest are: ");
    setlocale(LC_ALL, "en_US.utf8");

    const long dest_size = sizeof dest / sizeof *dest;
    for(wchar_t* p = dest; p - dest != dest_size; ++p) {
        *p ? printf("%lc ", *p)
           : printf("\\0 ");
    }
}

The contents of dest are:
わ ゐ \0 \0 お \0

Referenzen

Siehe auch