ОБЗОР
#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:
- _XOPEN_SOURCE >= 700 || _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) |