atol(3p) - phpMan

ATOL(P)                                                                ATOL(P)



NAME
       atol, atoll - convert a string to a long integer

SYNOPSIS
       #include <stdlib.h>

       long atol(const char *str);
       long long atoll(const char *nptr);


DESCRIPTION
       The call atol(str) shall be equivalent to:


              strtol(str, (char **)NULL, 10)

       The call atoll(str) shall be equivalent to:


              strtoll(nptr, (char **)NULL, 10)

       except  that the handling of errors may differ. If the value cannot be represented,
       the behavior is undefined.

RETURN VALUE
       These functions shall return the converted value if the value can be represented.

ERRORS
       No errors are defined.

       The following sections are informative.

EXAMPLES
       None.

APPLICATION USAGE
       The atol() function is subsumed by strtol() but is  retained  because  it  is  used
       extensively  in  existing code. If the number is not known to be in range, strtol()
       should be used because atol() is not required to perform any error checking.

RATIONALE
       None.

FUTURE DIRECTIONS
       None.

SEE ALSO
       strtol() , the Base Definitions volume of IEEE Std 1003.1-2001, <stdlib.h>

COPYRIGHT
       Portions of this text are reprinted and reproduced in electronic form from IEEE Std
       1003.1,  2003  Edition,  Standard  for Information Technology -- Portable Operating
       System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C)
       2001-2003  by  the  Institute  of Electrical and Electronics Engineers, Inc and The
       Open Group. In the event of any discrepancy between this version and  the  original
       IEEE  and The Open Group Standard, the original IEEE and The Open Group Standard is
       the  referee  document.  The  original  Standard  can   be   obtained   online   at
       http://www.opengroup.org/unix/online.html .



POSIX                                2003                              ATOL(P)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2009-01-08 04:12 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)