compiler/alib/strdup.c

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