summaryrefslogtreecommitdiff
path: root/src/lib/std_dtoa.h
blob: 5a439b64395ed141e1984c94417bcddfcb426fe3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
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
/*==============================================================================
 * Copyright (c) 2009,2013 QUALCOMM Technologies Inc. All Rights Reserved.
 * Qualcomm Technologies Confidential and Proprietary
==============================================================================*/

#ifndef STD_DTOA_H
#define STD_DTOA_H

//
// Constant Definitions
//

// For floating point numbers, the range of a double precision number is
// approximately +/- 10 ^ 308.25 as per the IEEE Standard 754.
// As such, the maximum size of the integer portion of the
// string is assumed to be 311 (309 + sign + \0). The maximum
// size of the fractional part is assumed to be 100. Thus, the
// maximum size of the string that would contain the number
// after conversion is safely assumed to be 420 (including any
// prefix, the null character and exponent specifiers 'e').
//
// The buffers that contain the converted integer and the fraction parts of
// the float are safely assumed to be of size 310.
#define STD_DTOA_FORMAT_FLOAT_SIZE           420
#define STD_DTOA_FORMAT_INTEGER_SIZE         311
#define STD_DTOA_FORMAT_FRACTION_SIZE        100

// Constants for operations on the IEEE 754 representation of double
// precision floating point numbers.
#define STD_DTOA_DP_SIGN_SHIFT_COUNT         63
#define STD_DTOA_DP_EXPONENT_SHIFT_COUNT     52
#define STD_DTOA_DP_EXPONENT_MASK            0x7ff
#define STD_DTOA_DP_EXPONENT_BIAS            1023
#define STD_DTOA_DP_MANTISSA_MASK            ( ( (uint64)1 << 52 ) - 1 )
#define STD_DTOA_DP_INFINITY_EXPONENT_ID     0x7FF
#define STD_DTOA_DP_MAX_EXPONENT             1023
#define STD_DTOA_DP_MIN_EXPONENT_NORM        -1022
#define STD_DTOA_DP_MIN_EXPONENT_DENORM      -1074
#define STD_DTOA_DP_MAX_EXPONENT_DEC         308
#define STD_DTOA_DP_MIN_EXPONENT_DEC_DENORM  -323

#define STD_DTOA_PRECISION_ROUNDING_VALUE    4
#define STD_DTOA_DEFAULT_FLOAT_PRECISION     6

#define STD_DTOA_NEGATIVE_INF_UPPER_CASE     "-INF"
#define STD_DTOA_NEGATIVE_INF_LOWER_CASE     "-inf"
#define STD_DTOA_POSITIVE_INF_UPPER_CASE     "INF"
#define STD_DTOA_POSITIVE_INF_LOWER_CASE     "inf"
#define STD_DTOA_NAN_UPPER_CASE              "NAN"
#define STD_DTOA_NAN_LOWER_CASE              "nan"
#define STD_DTOA_FP_POSITIVE_INF             0x7FF0000000000000uLL
#define STD_DTOA_FP_NEGATIVE_INF             0xFFF0000000000000uLL
#define STD_DTOA_FP_SNAN                     0xFFF0000000000001uLL
#define STD_DTOA_FP_QNAN                     0xFFFFFFFFFFFFFFFFuLL

//
// Useful Macros
//

#define MY_ISDIGIT(c)            ( ( (c) >= '0' ) && ( (c) <= '9' ) )
#define FP_EXPONENT(u)           ( ( ( (u) >> STD_DTOA_DP_EXPONENT_SHIFT_COUNT ) \
                                    & STD_DTOA_DP_EXPONENT_MASK ) - STD_DTOA_DP_EXPONENT_BIAS )
#define FP_EXPONENT_BIASED(u)    ( ( (u) >> STD_DTOA_DP_EXPONENT_SHIFT_COUNT ) \
                                    & STD_DTOA_DP_EXPONENT_MASK )
#define FP_MANTISSA_NORM(u)      ( ( (u) & STD_DTOA_DP_MANTISSA_MASK ) | \
                                    ( (uint64)1 << STD_DTOA_DP_EXPONENT_SHIFT_COUNT ) )
#define FP_MANTISSA_DENORM(u)    ( (u) & STD_DTOA_DP_MANTISSA_MASK )
#define FP_MANTISSA(u)           ( FP_EXPONENT_BIASED(u) ? FP_MANTISSA_NORM(u) : \
                                    FP_MANTISSA_DENORM(u) )
#define FP_SIGN(u)               ( (u) >> STD_DTOA_DP_SIGN_SHIFT_COUNT )
#define DOUBLE_TO_UINT64(d)      ( *( (uint64*) &(d) ) )
#define DOUBLE_TO_INT64(d)       ( *( (int64*) &(d) ) )
#define UINT64_TO_DOUBLE(u)      ( *( (double*) &(u) ) )

//
// Type Definitions
//

typedef enum
{
   FP_TYPE_UNKOWN = 0,
   FP_TYPE_NEGATIVE_INF,
   FP_TYPE_POSITIVE_INF,
   FP_TYPE_NAN,
   FP_TYPE_GENERAL,
} FloatingPointType;

//
// Function Declarations
//

#ifdef __cplusplus
extern "C" {
#endif // #ifdef __cplusplus

double fp_pow_10( int nPow );
double fp_round( double dNumber, int nPrecision );
int fp_log_10( double dNumber );
int fp_check_special_cases( double dNumber, FloatingPointType* pNumberType );
int std_dtoa_decimal( double dNumber, int nPrecision,
                      char acIntegerPart[ STD_DTOA_FORMAT_INTEGER_SIZE ],
                      char acFractionPart[ STD_DTOA_FORMAT_FRACTION_SIZE ] );
int std_dtoa_hex( double dNumber, int nPrecision, char cFormat,
                  char acIntegerPart[ STD_DTOA_FORMAT_INTEGER_SIZE ],
                  char acFractionPart[ STD_DTOA_FORMAT_FRACTION_SIZE ],
                  int* pnExponent );

#ifdef __cplusplus
}
#endif // #ifdef __cplusplus

#endif   // STD_DTOA_H