compiler/stdc/strncat.c

   1 /*
   2     Copyright © 1995-2012, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     C99 function strncat().
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <string.h>
  12
  13         char * strncat (
  14
  15 /*  SYNOPSIS */
  16         char       * dest,
  17         const char * src,
  18         size_t       n)
  19
  20 /*  FUNCTION
  21         Concatenates two strings. If src is longer than n characters, then
  22         only the first n characters are copied.
  23
  24     INPUTS
  25         dest - src is appended to this string. Make sure that there
  26                 is enough room for src.
  27         src - This string is appended to dest
  28         n - No more than this number of characters of src are copied.
  29
  30     RESULT
  31         dest.
  32
  33     NOTES
  34         The routine makes no checks if dest is large enough. The size of
  35         dest must be at least strlen(dest)+n+1.
  36
  37     EXAMPLE
  38         char buffer[64];
  39
  40         strcpy (buffer, "Hello ");
  41         strncat (buffer, "World.!!", 6);
  42
  43         // Buffer now contains "Hello World."
  44
  45     BUGS
  46
  47     SEE ALSO
  48
  49     INTERNALS
  50
  51 ******************************************************************************/
  52 {
  53     char * d = dest;
  54
  55     while (*dest)
  56         dest ++;
  57
  58     while (n && (*dest = *src))
  59     {
  60         n --;
  61         dest ++; src ++;
  62     }
  63     *dest = 0; /* null-terminate conctenated string */
  64
  65     return d;
  66 } /* strncat */