compiler/clib/atol.c

   1 /*
   2     Copyright © 1995-2003, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     ANSI C function atol().
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <stdlib.h>
  12
  13         long atol (
  14
  15 /*  SYNOPSIS */
  16         const char * str)
  17
  18 /*  FUNCTION
  19         Convert a string of digits into an long integer.
  20
  21     INPUTS
  22         str - The string which should be converted. Leading
  23                 whitespace are ignored. The number may be prefixed
  24                 by a '+' or '-'.
  25
  26     RESULT
  27         The value of string str.
  28
  29     NOTES
  30
  31     EXAMPLE
  32         // returns 1
  33         atol ("  \t +1");
  34
  35         // returns 1
  36         atol ("1");
  37
  38         // returns -1
  39         atol ("  \n -1");
  40
  41     BUGS
  42
  43     SEE ALSO
  44         atof(), atoi(), strtod(), strtol(), strtoul()
  45
  46     INTERNALS
  47
  48 ******************************************************************************/
  49 {
  50     return strtol (str, (char **)NULL, 10);
  51 } /* atol */