ИМЯ

wcpncpy - копирует широкосимвольную строку фиксированной длины и возвращает указатель на её конец

ОБЗОР

#include <wchar.h>

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

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

wcpncpy():

Начиная с glibc 2.10:: _POSIX_C_SOURCE >= 200809L
До glibc 2.10:: _GNU_SOURCE

ОПИСАНИЕ

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

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

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

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

Функция wcpncpy() возвращает указатель на последний записанный широкий символ, то есть на dest+n-1.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс	Атрибут	Значение
wcpncpy()	Безвредность в нитях	MT-Safe

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

POSIX.1-2008.

СМОТРИТЕ ТАКЖЕ

stpncpy(3), wcsncpy(3)