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);

Параметры

Возвращаемое значение

Примечания

При типичном использовании count — это количество элементов в целевом массиве.

Хотя усечение для помещения в целевой буфер представляет угрозу безопасности и, следовательно, является нарушением ограничений времени выполнения для wcsncpy_s, можно получить поведение усечения, указав count равным размеру целевого массива минус один: при этом будут скопированы первые count широких символов и добавлен завершающий нулевой широкий символ, как обычно:

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

Пример

#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

Ссылки

См. также