wcpncpy - копирует широкосимвольную строку фиксированной длины и возвращает
wcpncpy(3)
копирует широкосимвольную строку фиксированной длины и возвращает
ОБЗОР
#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)
СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2008.
