term% cat index.txt ATOF(2) System Calls Manual ATOF(2)
NAME
atof, atoi, atol, atoll, charstod, strtod, strtol, strtoll, strtoul,
strtoull - convert text to numbers
SYNOPSIS
#include <u.h>
#include <libc.h>
double atof(char *nptr)
int atoi(char *nptr)
long atol(char *nptr)
vlong atoll(char *nptr)
double charstod(int (*f)(void *), void *a)
double strtod(char *nptr, char **rptr)
long strtol(char *nptr, char **rptr, int base)
vlong strtoll(char *nptr, char **rptr, int base)
ulong strtoul(char *nptr, char **rptr, int base)
uvlong strtoull(char *nptr, char **rptr, int base)
DESCRIPTION
Atof, atoi, atol, and atoll convert a string pointed to by nptr to
floating, integer, long integer, and long long integer (vlong) repre‐
sentation respectively. The first unrecognized character ends the
string. Leading C escapes are understood, as in strtol with base zero
(described below).
Atof recognizes an optional string of tabs and spaces, then an optional
sign, then a string of digits optionally containing a decimal point,
then an optional or followed by an optionally signed integer.
Atoi and atol recognize an optional string of tabs and spaces, then an
optional sign, then a string of decimal digits.
Strtod, strtol, strtoll, strtoul, and strtoull behave similarly to atof
and atol and, if rptr is not zero, set *rptr to point to the input
character immediately after the string converted.
Strtol, strtoll, strtoul, and strtoull interpret the digit string in
the specified base, from 2 to 36, each digit being less than the base.
Digits with value over 9 are represented by letters, a-z or A-Z. If
base is 0, the input is interpreted as an integral constant in the
style of C (with no suffixed type indicators): numbers are octal if
they begin with hexadecimal if they begin with or otherwise decimal.
Charstod interprets floating point numbers in the manner of atof, but
gets successive characters by calling (*f)(a). The last call to f ter‐
minates the scan, so it must have returned a character that is not a
legal continuation of a number. Therefore, it may be necessary to back
up the input stream one character after calling charstod.
SOURCE
/sys/src/libc/port
SEE ALSO
fscanf(2)
DIAGNOSTICS
Zero is returned if the beginning of the input string is not inter‐
pretable as a number; even in this case, rptr will be updated.
BUGS
Atoi, atol, and atoll accept octal and hexadecimal numbers in the style
of C, contrary to the ANSI specification.
ATOF(2)