mirror of
git://sourceware.org/git/newlib-cygwin.git
synced 2025-01-16 03:19:54 +08:00
239c2bf93e
* libc/misc/unctrl.c: Replace FUNCTION description.
* libc/signal/signal.c: Remove documentation for raise and _raise_r.
* libc/stdio/getdelim.c: Fix spelling errors.
* libc/stdio/getw.c: Put RETURNS on a separate line. Fix punctuation.
* libc/stdio/putw.c: Likewise.
* libc/stdlib/a64l.c: Fix formatting, spelling and punctuation in
documentation.
* libc/stdlib/assert.c: Do not capitalize FUNCTION description.
* libc/stdlib/efgcvt.c: Add spaces to FUNCTION description.
* libc/stdlib/envlock.c: Use em-dash in FUNCTION description.
* libc/stdlib/mlock.c: Likewise.
* libc/stdlib/mstats.c: Likewise.
* libc/time/tzlock.c: Likewise.
* libc/stdlib/rand.c: Use "multi-threaded" and "thread-safe" in NOTES.
* libc/stdlib/rand48.c: Remove extra space in FUNCTION description
and hyphenate "pseudo-random".
* libc/string/bcmp.c: Remove extra blank lines in documentation.
* libc/string/strncat.c: Likewise.
* libc/string/memchr.c: Remove extra ">" character in documentation.
* libc/string/strcspn.c: Use "characters" instead of "chars".
* libc/string/strpbrk.c: Likewise.
* libc/string/strerror_r.c: Capitalize "GNU".
* libc/string/strnlen.c: Likewise.
* libc/string/strtok.c: Fix formatting, spelling and punctuation in
documentation. Use "multi-threaded" and "thread-safe" in NOTES.
* libc/string/wcscat.c: Split PORTABILITY into two paragraphs.
* libc/string/wcschr.c: Likewise.
* libc/string/wcscmp.c: Likewise.
* libc/string/wcscpy.c: Likewise.
* libc/string/wcscspn.c: Likewise.
* libc/string/wcslen.c: Likewise.
* libc/string/wcsncat.c: Likewise.
* libc/string/wcsncmp.c: Likewise.
* libc/string/wcsncpy.c: Likewise.
* libc/string/wcsnlen.c: Likewise.
* libc/string/wcspbrk.c: Likewise.
* libc/string/wcsrchr.c: Likewise.
* libc/string/wcsspn.c: Likewise.
* libc/string/wmemchr.c: Likewise.
* libc/string/wmemcmp.c: Likewise.
* libc/string/wmemcpy.c: Likewise.
* libc/string/wmemset.c: Likewise.
* libc/string/wmemmove.c: Likewise. Also fix FUNCTION description.
* libc/string/wcswidth.c: Formatting and punctuation in documentation.
* libc/string/wcwidth.c: Likewise.
* libm/common/s_modf.c: Remove extra period from documentation.
* libm/math/s_isnan.c: Fix formatting, grammar and punctuation in
documentation.
* libm/mathfp/s_isnan.c: Likewise.
* libm/math/s_ldexp.c: Fix punctuation.
* libm/mathfp/s_ldexp.c: Likewise.
* libm/math/w_log.c: Likewise.
* libm/mathfp/s_logarithm.c: Likewise.
* libm/math/w_j0.c: Add spaces to FUNCTION description.
* libm/mathfp/w_jn.c: Likewise.
115 lines
2.5 KiB
C
115 lines
2.5 KiB
C
/*
|
|
FUNCTION
|
|
<<strncat>>---concatenate strings
|
|
|
|
INDEX
|
|
strncat
|
|
|
|
ANSI_SYNOPSIS
|
|
#include <string.h>
|
|
char *strncat(char *<[dst]>, const char *<[src]>, size_t <[length]>);
|
|
|
|
TRAD_SYNOPSIS
|
|
#include <string.h>
|
|
char *strncat(<[dst]>, <[src]>, <[length]>)
|
|
char *<[dst]>;
|
|
char *<[src]>;
|
|
size_t <[length]>;
|
|
|
|
DESCRIPTION
|
|
<<strncat>> appends not more than <[length]> characters from
|
|
the string pointed to by <[src]> (including the terminating
|
|
null character) to the end of the string pointed to by
|
|
<[dst]>. The initial character of <[src]> overwrites the null
|
|
character at the end of <[dst]>. A terminating null character
|
|
is always appended to the result
|
|
|
|
WARNINGS
|
|
Note that a null is always appended, so that if the copy is
|
|
limited by the <[length]> argument, the number of characters
|
|
appended to <[dst]> is <<n + 1>>.
|
|
|
|
RETURNS
|
|
This function returns the initial value of <[dst]>
|
|
|
|
PORTABILITY
|
|
<<strncat>> is ANSI C.
|
|
|
|
<<strncat>> requires no supporting OS subroutines.
|
|
|
|
QUICKREF
|
|
strncat ansi pure
|
|
*/
|
|
|
|
#include <string.h>
|
|
#include <limits.h>
|
|
|
|
/* Nonzero if X is aligned on a "long" boundary. */
|
|
#define ALIGNED(X) \
|
|
(((long)X & (sizeof (long) - 1)) == 0)
|
|
|
|
#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
|
|
|
|
char *
|
|
_DEFUN (strncat, (s1, s2, n),
|
|
char *s1 _AND
|
|
_CONST char *s2 _AND
|
|
size_t n)
|
|
{
|
|
#if defined(PREFER_SIZE_OVER_SPEED) || defined(__OPTIMIZE_SIZE__)
|
|
char *s = s1;
|
|
|
|
while (*s1)
|
|
s1++;
|
|
while (n-- != 0 && (*s1++ = *s2++))
|
|
{
|
|
if (n == 0)
|
|
*s1 = '\0';
|
|
}
|
|
|
|
return s;
|
|
#else
|
|
char *s = s1;
|
|
|
|
/* Skip over the data in s1 as quickly as possible. */
|
|
if (ALIGNED (s1))
|
|
{
|
|
unsigned long *aligned_s1 = (unsigned long *)s1;
|
|
while (!DETECTNULL (*aligned_s1))
|
|
aligned_s1++;
|
|
|
|
s1 = (char *)aligned_s1;
|
|
}
|
|
|
|
while (*s1)
|
|
s1++;
|
|
|
|
/* s1 now points to the its trailing null character, now copy
|
|
up to N bytes from S2 into S1 stopping if a NULL is encountered
|
|
in S2.
|
|
|
|
It is not safe to use strncpy here since it copies EXACTLY N
|
|
characters, NULL padding if necessary. */
|
|
while (n-- != 0 && (*s1++ = *s2++))
|
|
{
|
|
if (n == 0)
|
|
*s1 = '\0';
|
|
}
|
|
|
|
return s;
|
|
#endif /* not PREFER_SIZE_OVER_SPEED */
|
|
}
|