50 lines
1.3 KiB
ReStructuredText
50 lines
1.3 KiB
ReStructuredText
PR_strtod
|
|
=========
|
|
|
|
Converts the prefix of a decimal string to the nearest double-precision
|
|
floating point number.
|
|
|
|
|
|
Syntax
|
|
------
|
|
|
|
.. code::
|
|
|
|
#include <prdtoa.h>
|
|
|
|
PRFloat64 PR_strtod(const char *s00, char **se);
|
|
|
|
|
|
Parameters
|
|
~~~~~~~~~~
|
|
|
|
The function has these parameters:
|
|
|
|
``s00``
|
|
The input string to be scanned.
|
|
``se``
|
|
A pointer that, if not ``NULL``, will be assigned the address of the
|
|
last character scanned in the input string.
|
|
|
|
|
|
Returns
|
|
~~~~~~~
|
|
|
|
The result of the conversion is a ``PRFloat64`` value equivalent to the
|
|
input string. If the parameter ``se`` is not ``NULL`` the location it
|
|
references is also set.
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
:ref:`PR_strtod` converts the prefix of the input decimal string pointed to
|
|
by ``s00`` to a nearest double-precision floating point number. Ties are
|
|
broken by the IEEE round-even rule. The string is scanned up to the
|
|
first unrecognized character. If the value of ``se`` is not
|
|
(``char **``) ``NULL``, :ref:`PR_strtod` stores a pointer to the character
|
|
terminating the scan in ``*se``. If the answer would overflow, a
|
|
properly signed ``HUGE_VAL`` (infinity) is returned. If the answer would
|
|
underflow, a properly signed 0 is returned. In both cases,
|
|
``PR_GetError()`` returns the error code ``PR_RANGE_ERROR``. If no
|
|
number can be formed, ``se`` is set to ``s00``, and 0 is returned.
|