Kannel: Open Source WAP and SMS gateway  svn-r5335
wsieee754.h
Go to the documentation of this file.
1 /* ====================================================================
2  * The Kannel Software License, Version 1.0
3  *
4  * Copyright (c) 2001-2018 Kannel Group
5  * Copyright (c) 1998-2001 WapIT Ltd.
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  *
12  * 1. Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  *
15  * 2. Redistributions in binary form must reproduce the above copyright
16  * notice, this list of conditions and the following disclaimer in
17  * the documentation and/or other materials provided with the
18  * distribution.
19  *
20  * 3. The end-user documentation included with the redistribution,
21  * if any, must include the following acknowledgment:
22  * "This product includes software developed by the
23  * Kannel Group (http://www.kannel.org/)."
24  * Alternately, this acknowledgment may appear in the software itself,
25  * if and wherever such third-party acknowledgments normally appear.
26  *
27  * 4. The names "Kannel" and "Kannel Group" must not be used to
28  * endorse or promote products derived from this software without
29  * prior written permission. For written permission, please
30  * contact org@kannel.org.
31  *
32  * 5. Products derived from this software may not be called "Kannel",
33  * nor may "Kannel" appear in their name, without prior written
34  * permission of the Kannel Group.
35  *
36  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39  * DISCLAIMED. IN NO EVENT SHALL THE KANNEL GROUP OR ITS CONTRIBUTORS
40  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
41  * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
42  * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
43  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
44  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
45  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
46  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
47  * ====================================================================
48  *
49  * This software consists of voluntary contributions made by many
50  * individuals on behalf of the Kannel Group. For more information on
51  * the Kannel Group, please see <http://www.kannel.org/>.
52  *
53  * Portions of this software are based upon software originally written at
54  * WapIT Ltd., Helsinki, Finland for the Kannel project.
55  */
56 
57 /*
58  *
59  * wsieee754.h
60  *
61  * Author: Markku Rossi <mtr@iki.fi>
62  *
63  * Copyright (c) 2000 WAPIT OY LTD.
64  * All rights reserved.
65  *
66  * Functions to manipulate ANSI/IEEE Std 754-1985 binary floating-point
67  * numbers.
68  *
69  */
70 
71 #ifndef WSIEEE754_H
72 #define WSIEEE754_H
73 
74 /********************* Types and definitions ****************************/
75 
76 /* Return codes for encoding and decoding functions. */
77 typedef enum
78 {
79  /* The operation was successful. */
81 
82  /* The value is `Not a Number' NaN. */
84 
85  /* The valueis positive infinity. */
87 
88  /* The value is negative infinity. */
91 
92 /********************* Special values ***********************************/
93 
94 /* `Not a Number' NaN */
95 extern unsigned char ws_ieee754_nan[4];
96 
97 /* Positive infinity. */
98 extern unsigned char ws_ieee754_positive_inf[4];
99 
100 /* Positive infinity. */
101 extern unsigned char ws_ieee754_negative_inf[4];
102 
103 /********************* Global functions *********************************/
104 
105 /* Encode the floating point number `value' to the IEEE-754 single
106  precision format. The function stores the encoded value to the
107  buffer `buf'. The buffer `buf' must have 32 bits (4 bytes) of
108  space. The function returns WsIeee754Result return value. It
109  describes the format of the encoded value in `buf'. In all cases,
110  the function generates the corresponding encoded value to the
111  buffer `buf'. */
112 WsIeee754Result ws_ieee754_encode_single(double value, unsigned char *buf);
113 
114 /* Decode the IEEE-754 encoded number `buf' into a floating point
115  number. The argument `buf' must have 32 bits of data. The
116  function returns a result code which describes the success of the
117  decode operation. If the result is WS_IEEE754_OK, the resulting
118  floating point number is returned in `value_return'. */
119 WsIeee754Result ws_ieee754_decode_single(unsigned char *buf,
120  double *value_return);
121 
122 /* Get the sign bit from the IEEE-754 single format encoded number
123  `buf'. The buffer `buf' must have 32 bits of data. */
124 WsUInt32 ws_ieee754_single_get_sign(unsigned char *buf);
125 
126 /* Get the exponent from the IEEE-754 single format encoded number
127  `buf'. The buffer `buf' must have 32 bits of data. The returned
128  value is the biased exponent. */
129 WsUInt32 ws_ieee754_single_get_exp(unsigned char *buf);
130 
131 /* Get the mantissa from the IEEE-754 single format encoded number
132  `buf'. The buffer `buf' must have 32 bits of data. */
133 WsUInt32 ws_ieee754_single_get_mant(unsigned char *buf);
134 
135 #endif /* not WSIEEE754_H */
unsigned long WsUInt32
Definition: wsint.h:122
unsigned char ws_ieee754_nan[4]
Definition: wsieee754.c:86
WsIeee754Result ws_ieee754_decode_single(unsigned char *buf, double *value_return)
Definition: wsieee754.c:199
WsUInt32 ws_ieee754_single_get_exp(unsigned char *buf)
Definition: wsieee754.c:262
WsIeee754Result
Definition: wsieee754.h:77
WsUInt32 ws_ieee754_single_get_mant(unsigned char *buf)
Definition: wsieee754.c:273
unsigned char ws_ieee754_negative_inf[4]
Definition: wsieee754.c:90
unsigned char ws_ieee754_positive_inf[4]
Definition: wsieee754.c:88
WsUInt32 ws_ieee754_single_get_sign(unsigned char *buf)
Definition: wsieee754.c:256
WsIeee754Result ws_ieee754_encode_single(double value, unsigned char *buf)
Definition: wsieee754.c:94
See file LICENSE for details about the license agreement for using, modifying, copying or deriving work from this software.