STPNCPY
Section: Linux Programmer's Manual (3)
Updated: 1999-07-25
Index
Return to Main Contents
NAME
stpncpy - copy a fixed-size string, returning a pointer to its end
SYNOPSIS
#define _GNU_SOURCE
#include <string.h>
char *stpncpy(char *dest, const char *src, size_t n);
DESCRIPTION
The
stpncpy()
function copies at most n characters from the string
pointed to by src, including the terminating aq\0aq 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 aq\0aq characters.
If the length strlen(src) is greater or equal to
n, the string pointed to by dest will
not be aq\0aq 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)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- CONFORMING TO
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 16:11:11 GMT, January 25, 2010