Return to strtol CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / MULTI

Annotation of coherent/a/usr/man/MULTI/strtol, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: strtol()                 General Function                strtol()
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Convert string to long integer
                      9: 
                     10: #iinncclluuddee <ssttddlliibb.hh>
                     11: lloonngg ssttrrttooll(_s_t_r_i_n_g, _t_a_i_l_p_t_r, _b_a_s_e)
                     12: char *_s_t_r_i_n_g; cchhaarr **_t_a_i_l_p_t_r; iinntt _b_a_s_e;
                     13: 
                     14: ssttrrttooll converts the number given  in _s_t_r_i_n_g to a lloonngg and returns
                     15: its value;  it is  a more general  version of the  function aattooll.
                     16: ssttrrttooll also stores a pointer to the first character following the
                     17: number through _t_a_i_l_p_t_r, provided _t_a_i_l_p_t_r is not NNUULLLL.
                     18: 
                     19: _b_a_s_e gives the base of the number being read, either 0 or a value
                     20: from 2  to 36.  If the  given _b_a_s_e is zero,  ssttrrttooll determines an
                     21: implicit base  for the number:  hexadecimal if the  number starts
                     22: with  00xx  or 00XX, octal  if the number  starts with 00,  or decimal
                     23: otherwise.  Alternatively,  you can specify a  _b_a_s_e between 2 and
                     24: 36.
                     25: 
                     26: ssttrrttooll  parses  _s_t_r_i_n_g into  three  portions: beginning,  subject
                     27: sequence, and tail.
                     28: 
                     29: The  _b_e_g_i_n_n_i_n_g consists  of zero  or more  white-space characters
                     30: that begin the string.
                     31: 
                     32: The _s_u_b_j_e_c_t  _s_e_q_u_e_n_c_e is  the portion  of the string  that ssttrrttooll
                     33: converts into a lloonngg.  It consists of an optional sign character,
                     34: an optional  prefix 00xx or  00XX if the  _b_a_s_e is 16,  and a nonempty
                     35: sequence of  _d_i_g_i_t_s in the  specified base.  For  example, if the
                     36: _b_a_s_e is 16, then  ssttrrttooll recognizes numeric characters `0' to `9'
                     37: and  alphabetic characters  `A'  through `F'  and `a'  to `f'  as
                     38: digits.  It continues to scan until it encounters a nondigit.
                     39: 
                     40: The _t_a_i_l  continues from the  end of the subject  sequence to the
                     41: null character that ends the string.
                     42: 
                     43: ssttrrttooll ignores the  beginning portion of the string.  It converts
                     44: the subject sequence to a  lloonngg. Finally, if _t_a_i_l_p_t_r is not NNUULLLL,
                     45: it sets the  pointer pointed to by _t_a_i_l_p_t_r to  the address of the
                     46: first character of the string's tail.
                     47: 
                     48: ssttrrttooll  returns a  lloonngg  representing the  value  of the  subject
                     49: sequence.  If  the input _s_t_r_i_n_g does not  specify a valid number,
                     50: it returns  zero and stores  the initial value  of _s_t_r_i_n_g through
                     51: _t_a_i_l_p_t_r. If the number it builds is too large or too small to fit
                     52: into a  lloonngg, it sets the  global variable eerrrrnnoo to  the value of
                     53: the macro EERRAANNGGEE and returns LLOONNGG_MMAAXX or LLOONNGG_MMIINN, respectively.
                     54: 
                     55: ***** See Also *****
                     56: 
                     57: aattooll, eerrrrnnoo, ggeenneerraall ffuunnccttiioonnss, lliimmiittss.hh, lloonngg, ssttddlliibb.hh, ssttrrttoouull
                     58: 
                     59: ***** Notes *****
                     60: 
                     61: ssttrrttooll  ignores initial  white space in  the input  _s_t_r_i_n_g. White
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: strtol()                 General Function                strtol()
                     70: 
                     71: 
                     72: 
                     73: space is  defined as  being all  characters so recognized  by the
                     74: function iissssppaaccee.
                     75: 
                     76: 
                     77: 
                     78: 
                     79: 
                     80: 
                     81: 
                     82: 
                     83: 
                     84: 
                     85: 
                     86: 
                     87: 
                     88: 
                     89: 
                     90: 
                     91: 
                     92: 
                     93: 
                     94: 
                     95: 
                     96: 
                     97: 
                     98: 
                     99: 
                    100: 
                    101: 
                    102: 
                    103: 
                    104: 
                    105: 
                    106: 
                    107: 
                    108: 
                    109: 
                    110: 
                    111: 
                    112: 
                    113: 
                    114: 
                    115: 
                    116: 
                    117: 
                    118: 
                    119: 
                    120: 
                    121: 
                    122: 
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.