comparison docs/ccguide/atof.refentry @ 564:1f4a17c1c56d

Several functions ready.
author roug
date Thu, 31 Oct 2002 22:05:32 +0000
parents bea58398bb15
children
comparison
equal deleted inserted replaced
563:e1be1b610076 564:1f4a17c1c56d
1 <refentry id="atof"> 1 <refentry id="atof">
2 <refnamediv> 2 <refnamediv>
3 <refname>atof</refname> 3 <refname>Atof</refname>
4 <refpurpose>Placeholder</refpurpose> 4 <refname>Atoi</refname>
5 <refname>Atol</refname>
6 <refpurpose>ASCII to number conversions</refpurpose>
5 </refnamediv> 7 </refnamediv>
6 8
7 <refsynopsisdiv> 9 <refsynopsisdiv>
8 <funcsynopsis> 10 <funcsynopsis>
9 <funcprototype> 11 <funcprototype>
10 <funcdef><function>atof</function></funcdef> 12 <funcdef>double <function>atof</function></funcdef>
11 <paramdef>type <parameter>arg1</parameter></paramdef> 13 <paramdef>char *<parameter>ptr</parameter></paramdef>
14 </funcprototype>
15
16 <funcprototype>
17 <funcdef>long <function>atol</function></funcdef>
18 <paramdef>char *<parameter>ptr</parameter></paramdef>
19 </funcprototype>
20
21 <funcprototype>
22 <funcdef>int <function>atoi</function></funcdef>
23 <paramdef>char *<parameter>ptr</parameter></paramdef>
12 </funcprototype> 24 </funcprototype>
13 </funcsynopsis> 25 </funcsynopsis>
14 26
15 </refsynopsisdiv> 27 </refsynopsisdiv>
16 28
17 <refsect1><title>Description</title> 29 <refsect1><title>Description</title>
18 <para> 30 <para>
19 Placeholder 31 Conversions of the string pointed to by "ptr" to the relevant
32 number type are carried out by these functions. They cease to
33 convert a number when the first unrecognized character is
34 encountered.
35 </para>
36 <para>
37 Each skips leading spaces and tab characters. Atof()
38 recognizes an optional sign followed by a digit string that
39 could possibly contain a decimal point, then an optional "e"
40 or "E", and optional sign and a digit string. Atol() and atoi()
41 recognize an optional sign and a digit string.
42 </para>
43 </refsect1>
44 <refsect1><title>Caveats</title>
45 <para>
46 Overflow causes unpredictable results. There are no error
47 indications.
20 </para> 48 </para>
21 </refsect1> 49 </refsect1>
22 </refentry> 50 </refentry>