explain_strtoll_or_die(3)                            explain_strtoll_or_die(3)



NNAAMMEE
       explain_strtoll_or_die  - convert a string to a long integer and report
       errors

SSYYNNOOPPSSIISS
       #include <libexplain/strtoll.h>
       long long explain_strtoll_or_die(const char *nptr, char  **endptr,  int
       base);
       long long explain_strtoll_on_error(const char *nptr, char **endptr, int
       base))

DDEESSCCRRIIPPTTIIOONN
       The eexxppllaaiinn__ssttrrttoollll__oorr__ddiiee function is used to call the _s_t_r_t_o_l_l(3) sys-
       tem call. On failure an explanation will be printed to _s_t_d_e_r_r, obtained
       from the _e_x_p_l_a_i_n___s_t_r_t_o_l_l(3) function, and then the  process  terminates
       by calling exit(EXIT_FAILURE).

       The  eexxppllaaiinn__ssttrrttoollll__oonn__eerrrroorr  function  is used to call the _s_t_r_t_o_l_l(3)
       system call. On failure an  explanation  will  be  printed  to  _s_t_d_e_r_r,
       obtained from the _e_x_p_l_a_i_n___s_t_r_t_o_l_l(3) function, but still returns to the
       caller.

       _n_p_t_r    The nptr, exactly as to be  passed  to  the  _s_t_r_t_o_l_l(3)  system
               call.

       _e_n_d_p_t_r  The  endptr,  exactly  as to be passed to the _s_t_r_t_o_l_l(3) system
               call.

       _b_a_s_e    The base, exactly as to be  passed  to  the  _s_t_r_t_o_l_l(3)  system
               call.

RREETTUURRNN VVAALLUUEE
       The  eexxppllaaiinn__ssttrrttoollll__oorr__ddiiee  function only returns on success, see _s_t_r_-
       _t_o_l_l(3) for more information. On failure,  prints  an  explanation  and
       exits, it does not return.

       The  eexxppllaaiinn__ssttrrttoollll__oonn__eerrrroorr  function always returns the value return
       by the wrapped _s_t_r_t_o_l_l(3) system call.

EEXXAAMMPPLLEE
       The eexxppllaaiinn__ssttrrttoollll__oorr__ddiiee function is intended to be used in a fashion
       similar to the following example:
              long long result = explain_strtoll_or_die(nptr, endptr, base);

SSEEEE AALLSSOO
       _s_t_r_t_o_l_l(3)
               convert a string to a long integer

       _e_x_p_l_a_i_n___s_t_r_t_o_l_l(3)
               explain _s_t_r_t_o_l_l(3) errors

       _e_x_i_t(2) terminate the calling process

CCOOPPYYRRIIGGHHTT
       libexplain version 1.4
       Copyright (C) 2009 Peter Miller



                                                     explain_strtoll_or_die(3)
