/*
|
/*
|
FUNCTION
|
FUNCTION
|
<<stpncpy>>---counted copy string returning a pointer to its end
|
<<stpncpy>>---counted copy string returning a pointer to its end
|
|
|
INDEX
|
INDEX
|
stpncpy
|
stpncpy
|
|
|
ANSI_SYNOPSIS
|
ANSI_SYNOPSIS
|
#include <string.h>
|
#include <string.h>
|
char *stpncpy(char *<[dst]>, const char *<[src]>, size_t <[length]>);
|
char *stpncpy(char *<[dst]>, const char *<[src]>, size_t <[length]>);
|
|
|
TRAD_SYNOPSIS
|
TRAD_SYNOPSIS
|
#include <string.h>
|
#include <string.h>
|
char *stpncpy(<[dst]>, <[src]>, <[length]>)
|
char *stpncpy(<[dst]>, <[src]>, <[length]>)
|
char *<[dst]>;
|
char *<[dst]>;
|
char *<[src]>;
|
char *<[src]>;
|
size_t <[length]>;
|
size_t <[length]>;
|
|
|
DESCRIPTION
|
DESCRIPTION
|
<<stpncpy>> copies not more than <[length]> characters from the
|
<<stpncpy>> copies not more than <[length]> characters from the
|
the string pointed to by <[src]> (including the terminating
|
the string pointed to by <[src]> (including the terminating
|
null character) to the array pointed to by <[dst]>. If the
|
null character) to the array pointed to by <[dst]>. If the
|
string pointed to by <[src]> is shorter than <[length]>
|
string pointed to by <[src]> is shorter than <[length]>
|
characters, null characters are appended to the destination
|
characters, null characters are appended to the destination
|
array until a total of <[length]> characters have been
|
array until a total of <[length]> characters have been
|
written.
|
written.
|
|
|
RETURNS
|
RETURNS
|
This function returns a pointer to the end of the destination string,
|
This function returns a pointer to the end of the destination string,
|
thus pointing to the trailing '\0', or, if the destination string is
|
thus pointing to the trailing '\0', or, if the destination string is
|
not null-terminated, pointing to dst + n.
|
not null-terminated, pointing to dst + n.
|
|
|
PORTABILITY
|
PORTABILITY
|
<<stpncpy>> is a GNU extension, candidate for inclusion into POSIX/SUSv4.
|
<<stpncpy>> is a GNU extension, candidate for inclusion into POSIX/SUSv4.
|
|
|
<<stpncpy>> requires no supporting OS subroutines.
|
<<stpncpy>> requires no supporting OS subroutines.
|
|
|
QUICKREF
|
QUICKREF
|
stpncpy gnu
|
stpncpy gnu
|
*/
|
*/
|
|
|
#include <string.h>
|
#include <string.h>
|
#include <limits.h>
|
#include <limits.h>
|
|
|
/*SUPPRESS 560*/
|
/*SUPPRESS 560*/
|
/*SUPPRESS 530*/
|
/*SUPPRESS 530*/
|
|
|
/* Nonzero if either X or Y is not aligned on a "long" boundary. */
|
/* Nonzero if either X or Y is not aligned on a "long" boundary. */
|
#define UNALIGNED(X, Y) \
|
#define UNALIGNED(X, Y) \
|
(((long)X & (sizeof (long) - 1)) | ((long)Y & (sizeof (long) - 1)))
|
(((long)X & (sizeof (long) - 1)) | ((long)Y & (sizeof (long) - 1)))
|
|
|
#if LONG_MAX == 2147483647L
|
#if LONG_MAX == 2147483647L
|
#define DETECTNULL(X) (((X) - 0x01010101) & ~(X) & 0x80808080)
|
#define DETECTNULL(X) (((X) - 0x01010101) & ~(X) & 0x80808080)
|
#else
|
#else
|
#if LONG_MAX == 9223372036854775807L
|
#if LONG_MAX == 9223372036854775807L
|
/* Nonzero if X (a long int) contains a NULL byte. */
|
/* Nonzero if X (a long int) contains a NULL byte. */
|
#define DETECTNULL(X) (((X) - 0x0101010101010101) & ~(X) & 0x8080808080808080)
|
#define DETECTNULL(X) (((X) - 0x0101010101010101) & ~(X) & 0x8080808080808080)
|
#else
|
#else
|
#error long int is not a 32bit or 64bit type.
|
#error long int is not a 32bit or 64bit type.
|
#endif
|
#endif
|
#endif
|
#endif
|
|
|
#ifndef DETECTNULL
|
#ifndef DETECTNULL
|
#error long int is not a 32bit or 64bit byte
|
#error long int is not a 32bit or 64bit byte
|
#endif
|
#endif
|
|
|
#define TOO_SMALL(LEN) ((LEN) < sizeof (long))
|
#define TOO_SMALL(LEN) ((LEN) < sizeof (long))
|
|
|
char *
|
char *
|
_DEFUN (stpncpy, (dst, src),
|
_DEFUN (stpncpy, (dst, src),
|
char *dst _AND
|
char *dst _AND
|
_CONST char *src _AND
|
_CONST char *src _AND
|
size_t count)
|
size_t count)
|
{
|
{
|
char *ret = NULL;
|
char *ret = NULL;
|
|
|
#if !defined(PREFER_SIZE_OVER_SPEED) && !defined(__OPTIMIZE_SIZE__)
|
#if !defined(PREFER_SIZE_OVER_SPEED) && !defined(__OPTIMIZE_SIZE__)
|
long *aligned_dst;
|
long *aligned_dst;
|
_CONST long *aligned_src;
|
_CONST long *aligned_src;
|
|
|
/* If SRC and DEST is aligned and count large enough, then copy words. */
|
/* If SRC and DEST is aligned and count large enough, then copy words. */
|
if (!UNALIGNED (src, dst) && !TOO_SMALL (count))
|
if (!UNALIGNED (src, dst) && !TOO_SMALL (count))
|
{
|
{
|
aligned_dst = (long*)dst;
|
aligned_dst = (long*)dst;
|
aligned_src = (long*)src;
|
aligned_src = (long*)src;
|
|
|
/* SRC and DEST are both "long int" aligned, try to do "long int"
|
/* SRC and DEST are both "long int" aligned, try to do "long int"
|
sized copies. */
|
sized copies. */
|
while (count >= sizeof (long int) && !DETECTNULL(*aligned_src))
|
while (count >= sizeof (long int) && !DETECTNULL(*aligned_src))
|
{
|
{
|
count -= sizeof (long int);
|
count -= sizeof (long int);
|
*aligned_dst++ = *aligned_src++;
|
*aligned_dst++ = *aligned_src++;
|
}
|
}
|
|
|
dst = (char*)aligned_dst;
|
dst = (char*)aligned_dst;
|
src = (char*)aligned_src;
|
src = (char*)aligned_src;
|
}
|
}
|
#endif /* not PREFER_SIZE_OVER_SPEED */
|
#endif /* not PREFER_SIZE_OVER_SPEED */
|
|
|
while (count > 0)
|
while (count > 0)
|
{
|
{
|
--count;
|
--count;
|
if ((*dst++ = *src++) == '\0')
|
if ((*dst++ = *src++) == '\0')
|
{
|
{
|
ret = dst - 1;
|
ret = dst - 1;
|
break;
|
break;
|
}
|
}
|
}
|
}
|
|
|
while (count-- > 0)
|
while (count-- > 0)
|
*dst++ = '\0';
|
*dst++ = '\0';
|
|
|
return ret ? ret : dst;
|
return ret ? ret : dst;
|
}
|
}
|
|
|
