compiler/clib/stccpy.c

   1 /*
   2     Copyright © 2003, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     C function stccpy().
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <string.h>
  12
  13         size_t stccpy (
  14
  15 /*  SYNOPSIS */
  16         char       * dest,
  17         const char * src,
  18         size_t       n)
  19
  20 /*  FUNCTION
  21         Copy a string. Works like an assignment "dest=src;". At most
  22         n characters are copied.
  23
  24     INPUTS
  25         dest - The string is copied into this variable. Make sure it is
  26                 large enough.
  27         src - This is the new contents of dest.
  28         n - How many characters to copy at most. If the string src is
  29                 smaller than that, only strlen(str)+1 bytes are copied.
  30
  31     RESULT
  32         The number of copied characters.
  33
  34     NOTES
  35         No check is beeing made that dest is large enough for src.
  36
  37     EXAMPLE
  38
  39     BUGS
  40
  41     SEE ALSO
  42         strncpy()
  43
  44     INTERNALS
  45
  46 ******************************************************************************/
  47 {
  48     char * ptr = dest;
  49
  50     while (n>1 && *src)
  51     {
  52         *ptr = *src;
  53         ptr ++;
  54         src ++;
  55         n--;
  56     }
  57
  58     *ptr++ = '\0';
  59
  60     return (ptr-dest);
  61 } /* stccpy */