STPNCPY(3) Linux Programmer's Manual STPNCPY(3)
NAME
stpncpy - copy a fixed-size string, returning a pointer to its end
SYNOPSIS
#include <string.h>
char *stpncpy(char *dest, const char *src, size_t n);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
stpncpy():
Since glibc 2.10:
_XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
Before glibc 2.10:
_GNU_SOURCE
DESCRIPTION
The stpncpy() function copies at most n characters from the string pointed to by src, including the terminating ' ' character, to the
array pointed to by dest. Exactly n characters are written at dest. If the length strlen(src) is smaller than n, the remaining characters
in the array pointed to by dest are filled with ' ' characters. If the length strlen(src) is greater or equal to n, the string pointed to
by dest will not be ' ' terminated.
The strings may not overlap.
The programmer must ensure that there is room for at least n characters at dest.
RETURN VALUE
stpncpy() returns a pointer to the terminating null in dest, or, if dest is not null-terminated, dest + n.
CONFORMING TO
This function is a GNU extension.
SEE ALSO
strncpy(3), wcpncpy(3), feature_test_macros(7)
COLOPHON
This page is part of release 3.27 of the Linux man-pages project. A description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
GNU
2010-09-15 STPNCPY(3)
