table of contents
STPNCPY(3) | Руководство программиста Linux | STPNCPY(3) |
ИМЯ¶
stpncpy - копирование строки фиксированной длины с возвращением указателя на её конец
ОБЗОР¶
#include <string.h> char *stpncpy(char *dest, const char *src, size_t n);
Требования
макроса
тестирования
свойств
для glibc (см.
feature_test_macros(7)):
stpncpy():
- Начиная с glibc 2.10:
- _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
- До glibc 2.10:
- _GNU_SOURCE
ОПИСАНИЕ¶
Функция stpncpy() копирует по крайней мере n символов из строки, на которую ссылается указатель src, включая конечный байт null ('\0'), в массив по указателю dest. В dest будет записано точно n символов. Если длина strlen(src) меньше n, то оставшиеся символы в массиве dest будут заполнены байтами null ('\'). Если длина strlen(src) больше или равна n, то строка, на которую ссылается указатель dest, не будет завершаться null.
Строки не должны пересекаться.
Программист должен быть уверен, что в dest достаточно места для по крайней мере n символов.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
stpncpy() возвращает указатель на завершающий байт null в dest или, если dest не завершается null, dest + n.
СООТВЕТСТВИЕ СТАНДАРТАМ¶
Эта функция была добавлена в POSIX.1-2008. До этого она считалась расширением GNU.
СМОТРИТЕ ТАКЖЕ¶
2011-09-28 | GNU |