wcsncpy(3) копирует широкосимвольную строку фиксированной длины

ОБЗОР

#include <wchar.h>


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

ОПИСАНИЕ

Функция wcsncpy() является эквивалентом strncpy(3) для широких символов. Она копирует, как минимум, n широких символов из широкосимвольной строки, на которую указывает src (включая конечный символ (L'\')), в массив, на который указывает dest. В dest записывается ровно n широких символов. Если длина wcslen(src) меньше n, то оставшиеся широкие символы в массиве, на который указывает dest, заполняются широкими символами null. Если длина wcslen(src) больше или равна n, то строка, на которую указывает dest, не будет оканчиваться широким символом null.

Строки не должны пересекаться.

Программист должен проверить, что в dest есть место по крайней мере для n широких символов.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

wcsncpy() возвращает dest.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).
ИнтерфейсАтрибутЗначение
wcsncpy() безвредность в нитяхбезвредно (MT-Safe)

СООТВЕТСТВИЕ СТАНДАРТАМ

POSIX.1-2001, POSIX.1-2008, C99.