2007-06-29 01:07:23 +08:00
|
|
|
/*
|
|
|
|
FUNCTION
|
|
|
|
<<stpncpy>>---counted copy string returning a pointer to its end
|
|
|
|
|
|
|
|
INDEX
|
|
|
|
stpncpy
|
|
|
|
|
|
|
|
ANSI_SYNOPSIS
|
|
|
|
#include <string.h>
|
* libc/sys/linux/include/netdb.h, libc/sys/linux/net/getaddrinfo.c,
libc/sys/linux/net/getnameinfo.c: Add restrict keyword to getnameinfo()
and getaddrinfo() to increase standards compliance and match glibc.
* libc/include/string.h, libc/string/memccpy.c, libc/string/memcpy.c,
libc/string/stpcpy.c, libc/string/stpncpy.c, libc/string/strcat.c,
libc/string/strncat.c, libc/string/strncpy.c, libc/string/strtok.c,
libc/string/strtok_r.c, libc/string/strxfrm.c
libc/machine/microblaze/strcpy.c, libc/machine/xscale/memcpy.c,
libc/machine/cris/memcpy.c: Add __restrict to prototype to
increase standards compliance.
2013-07-23 15:05:31 +08:00
|
|
|
char *stpncpy(char *restrict <[dst]>, const char *restrict <[src]>,
|
|
|
|
size_t <[length]>);
|
2007-06-29 01:07:23 +08:00
|
|
|
|
|
|
|
TRAD_SYNOPSIS
|
|
|
|
#include <string.h>
|
|
|
|
char *stpncpy(<[dst]>, <[src]>, <[length]>)
|
|
|
|
char *<[dst]>;
|
|
|
|
char *<[src]>;
|
|
|
|
size_t <[length]>;
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
<<stpncpy>> copies not more than <[length]> characters from the
|
|
|
|
the string pointed to by <[src]> (including the terminating
|
|
|
|
null character) to the array pointed to by <[dst]>. If the
|
|
|
|
string pointed to by <[src]> is shorter than <[length]>
|
|
|
|
characters, null characters are appended to the destination
|
|
|
|
array until a total of <[length]> characters have been
|
|
|
|
written.
|
|
|
|
|
|
|
|
RETURNS
|
|
|
|
This function returns a pointer to the end of the destination string,
|
|
|
|
thus pointing to the trailing '\0', or, if the destination string is
|
|
|
|
not null-terminated, pointing to dst + n.
|
|
|
|
|
|
|
|
PORTABILITY
|
|
|
|
<<stpncpy>> is a GNU extension, candidate for inclusion into POSIX/SUSv4.
|
|
|
|
|
|
|
|
<<stpncpy>> requires no supporting OS subroutines.
|
|
|
|
|
|
|
|
QUICKREF
|
|
|
|
stpncpy gnu
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <string.h>
|
|
|
|
#include <limits.h>
|
|
|
|
|
|
|
|
/*SUPPRESS 560*/
|
|
|
|
/*SUPPRESS 530*/
|
|
|
|
|
|
|
|
/* Nonzero if either X or Y is not aligned on a "long" boundary. */
|
|
|
|
#define UNALIGNED(X, Y) \
|
|
|
|
(((long)X & (sizeof (long) - 1)) | ((long)Y & (sizeof (long) - 1)))
|
|
|
|
|
|
|
|
#if LONG_MAX == 2147483647L
|
|
|
|
#define DETECTNULL(X) (((X) - 0x01010101) & ~(X) & 0x80808080)
|
|
|
|
#else
|
|
|
|
#if LONG_MAX == 9223372036854775807L
|
|
|
|
/* Nonzero if X (a long int) contains a NULL byte. */
|
|
|
|
#define DETECTNULL(X) (((X) - 0x0101010101010101) & ~(X) & 0x8080808080808080)
|
|
|
|
#else
|
|
|
|
#error long int is not a 32bit or 64bit type.
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifndef DETECTNULL
|
|
|
|
#error long int is not a 32bit or 64bit byte
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#define TOO_SMALL(LEN) ((LEN) < sizeof (long))
|
|
|
|
|
|
|
|
char *
|
|
|
|
_DEFUN (stpncpy, (dst, src),
|
* libc/sys/linux/include/netdb.h, libc/sys/linux/net/getaddrinfo.c,
libc/sys/linux/net/getnameinfo.c: Add restrict keyword to getnameinfo()
and getaddrinfo() to increase standards compliance and match glibc.
* libc/include/string.h, libc/string/memccpy.c, libc/string/memcpy.c,
libc/string/stpcpy.c, libc/string/stpncpy.c, libc/string/strcat.c,
libc/string/strncat.c, libc/string/strncpy.c, libc/string/strtok.c,
libc/string/strtok_r.c, libc/string/strxfrm.c
libc/machine/microblaze/strcpy.c, libc/machine/xscale/memcpy.c,
libc/machine/cris/memcpy.c: Add __restrict to prototype to
increase standards compliance.
2013-07-23 15:05:31 +08:00
|
|
|
char *__restrict dst _AND
|
|
|
|
_CONST char *__restrict src _AND
|
2007-06-29 01:07:23 +08:00
|
|
|
size_t count)
|
|
|
|
{
|
|
|
|
char *ret = NULL;
|
|
|
|
|
|
|
|
#if !defined(PREFER_SIZE_OVER_SPEED) && !defined(__OPTIMIZE_SIZE__)
|
|
|
|
long *aligned_dst;
|
|
|
|
_CONST long *aligned_src;
|
|
|
|
|
|
|
|
/* If SRC and DEST is aligned and count large enough, then copy words. */
|
|
|
|
if (!UNALIGNED (src, dst) && !TOO_SMALL (count))
|
|
|
|
{
|
|
|
|
aligned_dst = (long*)dst;
|
|
|
|
aligned_src = (long*)src;
|
|
|
|
|
|
|
|
/* SRC and DEST are both "long int" aligned, try to do "long int"
|
|
|
|
sized copies. */
|
|
|
|
while (count >= sizeof (long int) && !DETECTNULL(*aligned_src))
|
|
|
|
{
|
|
|
|
count -= sizeof (long int);
|
|
|
|
*aligned_dst++ = *aligned_src++;
|
|
|
|
}
|
|
|
|
|
|
|
|
dst = (char*)aligned_dst;
|
|
|
|
src = (char*)aligned_src;
|
|
|
|
}
|
|
|
|
#endif /* not PREFER_SIZE_OVER_SPEED */
|
|
|
|
|
|
|
|
while (count > 0)
|
|
|
|
{
|
|
|
|
--count;
|
|
|
|
if ((*dst++ = *src++) == '\0')
|
|
|
|
{
|
|
|
|
ret = dst - 1;
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
while (count-- > 0)
|
|
|
|
*dst++ = '\0';
|
|
|
|
|
|
|
|
return ret ? ret : dst;
|
|
|
|
}
|