Name

strtoimax, strtoumax — convert string to integer

Synopsis

#include <inttypes.h>
intmax_t strtoimax( const char *nptr,
  char **endptr,
  int base);
 
uintmax_t strtoumax( const char *nptr,
  char **endptr,
  int base);
 

DESCRIPTION

These functions are just like strtol(3) and strtoul(3), except that they return a value of type intmax_t and uintmax_t, respectively.

RETURN VALUE

On success, the converted value is returned. If nothing was found to convert, zero is returned. On overflow or underflow INTMAX_MAX or INTMAX_MIN or UINTMAX_MAX is returned, and errno is set to ERANGE.

ATTRIBUTES

Multithreading (see pthreads(7))

The strtoimax() and strtoumax() functions are thread-safe with exceptions. These functions can be safely used in multithreaded applications, as long as setlocale(3) is not called to change the locale during their execution.

CONFORMING TO

C99, POSIX.1-2001.

SEE ALSO

imaxabs(3), imaxdiv(3), strtol(3), strtoul(3), wcstoimax(3)

COLOPHON

This page is part of release 3.72 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at http://www.kernel.org/doc/man−pages/.


  Copyright (c) 2003 Andries Brouwer (aebcwi.nl)

%%%LICENSE_START(GPLv2+_DOC_FULL)
This is free documentation; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.

The GNU General Public License's references to "object code"
and "executables" are to be interpreted as the output of any
document formatting or typesetting system, including
intermediate and printed output.

This manual is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public
License along with this manual; if not, see
<http://www.gnu.org/licenses/>.
%%%LICENSE_END