compiler/alib/strdup.c

   1 /*
   2     Copyright © 2002-2003, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     AllocVec-based string duplication.
   6 */
   7
   8 #include "alib_intern.h"
   9 #include <exec/memory.h>
  10 #include <string.h>
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15 #define NO_INLINE_STDARG /* turn off inline def */
  16 #include <proto/exec.h>
  17
  18         STRPTR StrDup (
  19
  20 /*  SYNOPSIS */
  21         CONST_STRPTR    str)
  22
  23 /*  FUNCTION
  24         This function allocates enough space, and copies the given string
  25         into it.
  26
  27     INPUTS
  28         str - the string to duplicate
  29
  30     RESULT
  31         A string copy of the original string (possibly of zero length) or
  32         NULL if passed a NULL pointer.
  33
  34     NOTES
  35         This functions allocates the new string memory with AllocVec().
  36         Don't forget to call FreeVec() when you're done with it.
  37
  38     EXAMPLE
  39
  40     BUGS
  41
  42     SEE ALSO
  43         exec.library/AllocVec(), exec.library/FreeVec(), exec.library/CopyMem()
  44
  45     INTERNALS
  46
  47 *****************************************************************************/
  48 {
  49     STRPTR dup;
  50     ULONG  len;
  51
  52     if (str == NULL) return NULL;
  53
  54     len = strlen(str);
  55     dup = AllocVec(len + 1, MEMF_PUBLIC);
  56     if (dup != NULL) CopyMem(str, dup, len + 1);
  57
  58     return dup;
  59
  60 } /* StrDup */