wcpncpy(3)
| 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:
- _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.
СМОТРИТЕ ТАКЖЕ
| 2019-03-06 | GNU |
