table of contents
WCPNCPY(3) | Руководство программиста Linux | WCPNCPY(3) |
ИМЯ¶
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:
- _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.
СООТВЕТСТВИЕ СТАНДАРТАМ¶
POSIX.1-2008.
СМОТРИТЕ ТАКЖЕ¶
2011-10-01 | GNU |