Return to strtol.3l CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / p_man / man3

Annotation of researchv10dc/630/man/src/p_man/man3/strtol.3l, revision 1.1.1.1

1.1       root        1: .\"#ident      "@(#)ccsman:g3c/strtol  1.2"
                      2: '\"macro stdmacro
                      3: .nr X
                      4: .if \nX=0 .ds x} STRTOL 3L "630 MTG" "\&"
                      5: .TH \*(x}
                      6: .SH NAME
                      7: strtol, atol, atoi \- convert string to integer
                      8: .SH SYNOPSIS
                      9: .nf
                     10: .B long strtol (str, ptr, base)
                     11: .B char \(**str, \(**\(**ptr;
                     12: .B int base;
                     13: .PP
                     14: .B long atol (str)
                     15: .B char \(**str;
                     16: .PP
                     17: .B int atoi (str)
                     18: .B char \(**str;
                     19: .SH DESCRIPTION
                     20: .I strtol\^
                     21: returns (as a long integer) the value represented by the character string
                     22: pointed to by
                     23: .IR str .
                     24: The string is scanned up to the first
                     25: character inconsistent with the base.
                     26: Leading ``white-space'' characters
                     27: [as defined by
                     28: .I isspace\^
                     29: in
                     30: .IR ctype (3L)]
                     31: are ignored.
                     32: .PP
                     33: If the value of
                     34: .I ptr\^
                     35: is not (char \(**\(**)\s-1NULL\s+1,
                     36: a pointer to the character terminating the scan is returned in
                     37: the location pointed to by
                     38: .IR ptr .
                     39: If no integer can be formed,
                     40: that location
                     41: is set to
                     42: .IR str ,
                     43: and zero is returned.
                     44: .PP
                     45: If
                     46: .I base\^
                     47: is positive (and not greater than 36), it is used as
                     48: the base for conversion.
                     49: After an optional leading sign, leading zeros are ignored,
                     50: and ``0x'' or ``0X'' is ignored if
                     51: .I base\^
                     52: is 16.
                     53: .PP
                     54: If
                     55: .I base\^
                     56: is zero, the string itself determines the base thusly: After an
                     57: optional leading sign, a leading zero indicates octal conversion,
                     58: and a leading ``0x'' or ``0X'' indicates a hexadecimal conversion.  Otherwise,
                     59: decimal conversion is used.
                     60: .PP
                     61: Truncation from long to int can, of course, take place upon
                     62: assignment or by an explicit cast.
                     63: .PP
                     64: .I Atol(str)\^
                     65: is equivalent to
                     66: .IR "strtol(str, (char \(**\(**)\s-1NULL\s+1, 10)" .
                     67: .PP
                     68: .I Atoi(str)\^
                     69: is equivalent to
                     70: .IR "(int) strtol(str, (char \(**\(**)\s-1NULL\s+1, 10)" .
                     71: .SH SEE ALSO
                     72: atof(3L), ctype(3L).
                     73: .SH WARNING
                     74: Overflow conditions are ignored.
                     75: .Ee

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