STRTOIMAX(3)               POSIX Programmer's Manual              STRTOIMAX(3)



PPRROOLLOOGG
       This manual page is part of the POSIX Programmer's Manual.  The OS
       implementation of this interface may differ (consult the corresponding
       OS manual page for details of OS behavior), or the interface may not be
       implemented on OS.


NNAAMMEE
       strtoimax, strtoumax -- convert string to integer type

SSYYNNOOPPSSIISS
       #include <inttypes.h>

       intmax_t strtoimax(const char *restrict _n_p_t_r, char **restrict _e_n_d_p_t_r,
           int _b_a_s_e);
       uintmax_t strtoumax(const char *restrict _n_p_t_r, char **restrict _e_n_d_p_t_r,
           int _b_a_s_e);

DDEESSCCRRIIPPTTIIOONN
       The functionality described on this reference page is aligned with the
       ISO C standard. Any conflict between the requirements described here
       and the ISO C standard is unintentional. This volume of POSIX.1-2008
       defers to the ISO C standard.

       These functions shall be equivalent to the _s_t_r_t_o_l(), _s_t_r_t_o_l_l(),
       _s_t_r_t_o_u_l(), and _s_t_r_t_o_u_l_l() functions, except that the initial portion of
       the string shall be converted to iinnttmmaaxx__tt and uuiinnttmmaaxx__tt representation,
       respectively.

RREETTUURRNN VVAALLUUEE
       These functions shall return the converted value, if any.

       If no conversion could be performed, zero shall be returned and _e_r_r_n_o
       may be set to [[EEIINNVVAALL]].

       If the value of _b_a_s_e is not supported, 0 shall be returned and _e_r_r_n_o
       shall be set to [[EEIINNVVAALL]].

       If the correct value is outside the range of representable values,
       {INTMAX_MAX}, {INTMAX_MIN}, or {UINTMAX_MAX} shall be returned
       (according to the return type and sign of the value, if any), and _e_r_r_n_o
       shall be set to [[EERRAANNGGEE]].

EERRRROORRSS
       These functions shall fail if:

       EEIINNVVAALL The value of _b_a_s_e is not supported.

       EERRAANNGGEE The value to be returned is not representable.

       These functions may fail if:

       EEIINNVVAALL No conversion could be performed.

       _T_h_e _f_o_l_l_o_w_i_n_g _s_e_c_t_i_o_n_s _a_r_e _i_n_f_o_r_m_a_t_i_v_e_.

EEXXAAMMPPLLEESS
       None.

AAPPPPLLIICCAATTIIOONN UUSSAAGGEE
       Since the value of _*_e_n_d_p_t_r is unspecified if the value of _b_a_s_e is not
       supported, applications should either ensure that _b_a_s_e has a supported
       value (0 or between 2 and 36) before the call, or check for an [[EEIINNVVAALL]]
       error before examining _*_e_n_d_p_t_r.

RRAATTIIOONNAALLEE
       None.

FFUUTTUURREE DDIIRREECCTTIIOONNSS
       None.

SSEEEE AALLSSOO
       _s_t_r_t_o_l(), _s_t_r_t_o_u_l()

       The Base Definitions volume of POSIX.1-2008, <<iinnttttyyppeess..hh>>

CCOOPPYYRRIIGGHHTT
       Portions of this text are reprinted and reproduced in electronic form
       from IEEE Std 1003.1, 2013 Edition, Standard for Information Technology
       -- Portable Operating System Interface (POSIX), The Open Group Base
       Specifications Issue 7, Copyright (C) 2013 by the Institute of
       Electrical and Electronics Engineers, Inc and The Open Group.  (This is
       POSIX.1-2008 with the 2013 Technical Corrigendum 1 applied.) 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.unix.org/online.html .

       Any typographical or formatting errors that appear in this page are
       most likely to have been introduced during the conversion of the source
       files to man page format. To report such errors, see
       https://www.kernel.org/doc/man-pages/reporting_bugs.html .



IEEE/The Open Group                  2013                         STRTOIMAX(3)
