libecb/ecb.h

/*
 * libecb - http://software.schmorp.de/pkg/libecb
 *
 * Copyright (©) 2009-2011 Marc Alexander Lehmann <libecb@schmorp.de>
 * Copyright (©) 2011 Emanuele Giaquinta
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modifica-
 * tion, are permitted provided that the following conditions are met:
 *
 *   1.  Redistributions of source code must retain the above copyright notice,
 *       this list of conditions and the following disclaimer.
 *
 *   2.  Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MER-
 * CHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO
 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPE-
 * CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTH-
 * ERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 * OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef ECB_H
#define ECB_H

#ifdef _WIN32
  typedef   signed char   int8_t;
  typedef unsigned char  uint8_t;
  typedef   signed short  int16_t;
  typedef unsigned short uint16_t;
  typedef   signed int    int32_t;
  typedef unsigned int   uint32_t;
  #if __GNUC__
    typedef   signed long long int64_t;
    typedef unsigned long long uint64_t;
  #else
    typedef   signed __int64   int64_t;
    typedef unsigned __int64   uint64_t;
  #endif
#else
  #include <inttypes.h>
#endif

/* many compilers define _GNUC_ to some versions but then only implement
 * what their idiot authors think are the "more important" extensions,
 * causing enourmous grief in return for some better fake benchmark numbers.
 * or so.
 * we try to detect these and simply assume they are not gcc - if they have
 * an issue with that they should have done it right in the first place.
 */
#ifndef ECB_GCC_VERSION
  #if defined(__INTEL_COMPILER) || defined(__SUNPRO_C) || defined(__SUNPRO_CC) || defined(__llvm__) || defined(__clang__)
    #define ECB_GCC_VERSION(major,minor) 0
  #else
    #define ECB_GCC_VERSION(major,minor) (__GNUC__ > (major) || (__GNUC__ == (major) && __GNUC_MINOR__ >= (minor)))
  #endif
#endif

#define ECB_C99 (__STDC_VERSION__ >= 199901L)

#if __cplusplus
  #define ECB_INLINE static inline
#elif ECB_GCC_VERSION(2,5)
  #define ECB_INLINE static __inline__
#elif ECB_C99
  #define ECB_INLINE static inline
#else
  #define ECB_INLINE static
#endif

#if ECB_GCC_VERSION(3,3)
  #define ecb_restrict __restrict__
#elif ECB_C99
  #define ecb_restrict restrict
#else
  #define ecb_restrict
#endif

typedef int ecb_bool;

#define ECB_CONCAT_(a, b) a ## b
#define ECB_CONCAT(a, b) ECB_CONCAT_(a, b)
#define ECB_STRINGIFY_(a) # a
#define ECB_STRINGIFY(a) ECB_STRINGIFY_(a)

#define ecb_function_ ECB_INLINE

#if ECB_GCC_VERSION(3,1)
  #define ecb_attribute(attrlist)        __attribute__(attrlist)
  #define ecb_is_constant(expr)          __builtin_constant_p (expr)
  #define ecb_expect(expr,value)         __builtin_expect ((expr),(value))
  #define ecb_prefetch(addr,rw,locality) __builtin_prefetch (addr, rw, locality)
#else
  #define ecb_attribute(attrlist)
  #define ecb_is_constant(expr)          0
  #define ecb_expect(expr,value)         (expr)
  #define ecb_prefetch(addr,rw,locality)
#endif

/* no emulation for ecb_decltype */
#if ECB_GCC_VERSION(4,5)
  #define ecb_decltype(x) __decltype(x)
#elif ECB_GCC_VERSION(3,0)
  #define ecb_decltype(x) __typeof(x)
#endif

#define ecb_noinline   ecb_attribute ((__noinline__))
#define ecb_noreturn   ecb_attribute ((__noreturn__))
#define ecb_unused     ecb_attribute ((__unused__))
#define ecb_const      ecb_attribute ((__const__))
#define ecb_pure       ecb_attribute ((__pure__))

#if ECB_GCC_VERSION(4,3)
  #define ecb_artificial ecb_attribute ((__artificial__))
  #define ecb_hot        ecb_attribute ((__hot__))
  #define ecb_cold       ecb_attribute ((__cold__))
#else
  #define ecb_artificial
  #define ecb_hot
  #define ecb_cold
#endif

/* put around conditional expressions if you are very sure that the  */
/* expression is mostly true or mostly false. note that these return */
/* booleans, not the expression.                                     */
#define ecb_expect_false(expr) ecb_expect (!!(expr), 0)
#define ecb_expect_true(expr)  ecb_expect (!!(expr), 1)
/* for compatibility to the rest of the world */
#define ecb_likely(expr)   ecb_expect_true  (expr)
#define ecb_unlikely(expr) ecb_expect_false (expr)

/* count trailing zero bits and count # of one bits */
#if ECB_GCC_VERSION(3,4)
  #define ecb_ctz32(x)      __builtin_ctz      (x)
  #define ecb_popcount32(x) __builtin_popcount (x)
#else
  ecb_function_ int ecb_ctz32 (uint32_t x) ecb_const;
  ecb_function_ int
  ecb_ctz32 (uint32_t x)
  {
    int r = 0;

    x &= (uint32_t)-(int32_t)x; /* this isolates the lowest bit */

    if (x & 0xaaaaaaaa) r +=  1;
    if (x & 0xcccccccc) r +=  2;
    if (x & 0xf0f0f0f0) r +=  4;
    if (x & 0xff00ff00) r +=  8;
    if (x & 0xffff0000) r += 16;

    return r;
  }

  ecb_function_ int ecb_popcount32 (uint32_t x) ecb_const;
  ecb_function_ int
  ecb_popcount32 (uint32_t x)
  {
    x -=  (x >> 1) & 0x55555555;
    x  = ((x >> 2) & 0x33333333) + (x & 0x33333333);
    x  = ((x >> 4) + x) & 0x0f0f0f0f;
    x *= 0x01010101;

    return x >> 24;
  }
#endif

#if ECB_GCC_VERSION(4,3)
  #define ecb_bswap32(x) __builtin_bswap32 (x)
  #define ecb_bswap16(x) (__builtin_bswap32(x) >> 16)
#else
  ecb_function_ uint32_t ecb_bswap32 (uint32_t x) ecb_const;
  ecb_function_ uint32_t
  ecb_bswap32 (uint32_t x)
  {
    return (x >> 24)
        | ((x >>  8) & 0x0000ff00)
        | ((x <<  8) & 0x00ff0000)
        |  (x << 24);
  }

  ecb_function_ uint32_t ecb_bswap16 (uint32_t x) ecb_const;
  ecb_function_ uint32_t
  ecb_bswap16 (uint32_t x)
  {
    return ((x >>  8) & 0xff)
        |  ((x <<  8) & 0x00ff0000)
        |  (x << 24);
  }
#endif

#if ECB_GCC_VERSION(4,5)
  #define ecb_unreachable() __builtin_unreachable ()
#else
  /* this seems to work fine, but gcc always emits a warning for it :/ */
  ecb_function_ void ecb_unreachable (void) ecb_noreturn;
  ecb_function_ void ecb_unreachable (void) { }
#endif

/* try to tell the compiler that some condition is definitely true */
#define ecb_assume(cond) do { if (!(cond)) ecb_unreachable (); } while (0)

ecb_function_ unsigned char ecb_byteorder_helper (void) ecb_const;
ecb_function_ unsigned char
ecb_byteorder_helper (void)
{
  const uint32_t u = 0x11223344;
  return *(unsigned char *)&u;
}

ecb_function_ ecb_bool ecb_big_endian    (void) ecb_const;
ecb_function_ ecb_bool ecb_big_endian    (void) { return ecb_byteorder_helper () == 0x11; }
ecb_function_ ecb_bool ecb_little_endian (void) ecb_const;
ecb_function_ ecb_bool ecb_little_endian (void) { return ecb_byteorder_helper () == 0x44; }

#if ECB_GCC_VERSION(3,0) || ECB_C99
  #define ecb_mod(m,n) ((m) % (n) + ((m) % (n) < 0 ? (n) : 0))
#else
  #define ecb_mod(m,n) ((m) < 0 ? ((n) - 1 - ((-1 - (m)) % (n))) : ((m) % (n)))
#endif

#if ecb_cplusplus_does_not_suck
  /* does not work for local types (http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2657.htm) */
  template<typename T, int N>
  static inline int ecb_array_length (const T (&arr)[N])
  {
    return N;
  }
#else
  #define ecb_array_length(name) (sizeof (name) / sizeof (name [0]))
#endif

ECB_INLINE uint32_t ecb_rotr32 (uint32_t x, unsigned int count) ecb_const;
ECB_INLINE uint32_t
ecb_rotr32 (uint32_t x, unsigned int count)
{
  return (x << (32 - count)) | (x >> count);
}

ECB_INLINE uint32_t ecb_rotl32 (uint32_t x, unsigned int count) ecb_const;
ECB_INLINE uint32_t
ecb_rotl32 (uint32_t x, unsigned int count)
{
  return (x >> (32 - count)) | (x << count);
}

#endif

Revision:	1.45
Committed:	Mon Jun 13 09:00:30 2011 UTC (12 years, 11 months ago) by root
Content type:	text/plain
Branch:	MAIN
Changes since 1.44:	+1 -1 lines
Log Message:	* empty log message *
#	User	Rev	Content
1	root	1.1	/*
2	root	1.17	* libecb - http://software.schmorp.de/pkg/libecb
3	root	1.1	*
4	root	1.30	* Copyright (©) 2009-2011 Marc Alexander Lehmann <libecb@schmorp.de>
5	root	1.7	* Copyright (©) 2011 Emanuele Giaquinta
6	root	1.1	* All rights reserved.
7			*
8			* Redistribution and use in source and binary forms, with or without modifica-
9			* tion, are permitted provided that the following conditions are met:
10			*
11			* 1. Redistributions of source code must retain the above copyright notice,
12			* this list of conditions and the following disclaimer.
13			*
14			* 2. Redistributions in binary form must reproduce the above copyright
15			* notice, this list of conditions and the following disclaimer in the
16			* documentation and/or other materials provided with the distribution.
17			*
18			* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
19			* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MER-
20			* CHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
21			* EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPE-
22			* CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
23			* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
24			* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
25			* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTH-
26			* ERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
27			* OF THE POSSIBILITY OF SUCH DAMAGE.
28			*/
29
30			#ifndef ECB_H
31			#define ECB_H
32
33	root	1.44	#ifdef _WIN32
34			typedef signed char int8_t;
35			typedef unsigned char uint8_t;
36			typedef signed short int16_t;
37			typedef unsigned short uint16_t;
38			typedef signed int int32_t;
39			typedef unsigned int uint32_t;
40			#if __GNUC__
41			typedef signed long long int64_t;
42			typedef unsigned long long uint64_t;
43			#else
44			typedef signed __int64 int64_t;
45			typedef unsigned __int64 uint64_t;
46			#endif
47			#else
48			#include <inttypes.h>
49			#endif
50	root	1.6
51	root	1.12	/* many compilers define _GNUC_ to some versions but then only implement
52			* what their idiot authors think are the "more important" extensions,
53	root	1.18	* causing enourmous grief in return for some better fake benchmark numbers.
54			* or so.
55	root	1.12	* we try to detect these and simply assume they are not gcc - if they have
56			* an issue with that they should have done it right in the first place.
57			*/
58	root	1.14	#ifndef ECB_GCC_VERSION
59	root	1.43	#if defined(__INTEL_COMPILER) \|\| defined(__SUNPRO_C) \|\| defined(__SUNPRO_CC) \|\| defined(__llvm__) \|\| defined(__clang__)
60	root	1.37	#define ECB_GCC_VERSION(major,minor) 0
61			#else
62			#define ECB_GCC_VERSION(major,minor) (__GNUC__ > (major) \|\| (__GNUC__ == (major) && __GNUC_MINOR__ >= (minor)))
63			#endif
64	root	1.12	#endif
65	root	1.1
66	root	1.39	#define ECB_C99 (__STDC_VERSION__ >= 199901L)
67
68			#if __cplusplus
69	root	1.38	#define ECB_INLINE static inline
70			#elif ECB_GCC_VERSION(2,5)
71			#define ECB_INLINE static __inline__
72	root	1.39	#elif ECB_C99
73	root	1.38	#define ECB_INLINE static inline
74	root	1.29	#else
75	root	1.38	#define ECB_INLINE static
76			#endif
77
78			#if ECB_GCC_VERSION(3,3)
79			#define ecb_restrict __restrict__
80	root	1.39	#elif ECB_C99
81	root	1.38	#define ecb_restrict restrict
82			#else
83			#define ecb_restrict
84	root	1.4	#endif
85
86	root	1.38	typedef int ecb_bool;
87
88	root	1.8	#define ECB_CONCAT_(a, b) a ## b
89			#define ECB_CONCAT(a, b) ECB_CONCAT_(a, b)
90			#define ECB_STRINGIFY_(a) # a
91			#define ECB_STRINGIFY(a) ECB_STRINGIFY_(a)
92
93	root	1.39	#define ecb_function_ ECB_INLINE
94	root	1.3
95	root	1.1	#if ECB_GCC_VERSION(3,1)
96	root	1.37	#define ecb_attribute(attrlist) __attribute__(attrlist)
97			#define ecb_is_constant(expr) __builtin_constant_p (expr)
98			#define ecb_expect(expr,value) __builtin_expect ((expr),(value))
99			#define ecb_prefetch(addr,rw,locality) __builtin_prefetch (addr, rw, locality)
100			#else
101			#define ecb_attribute(attrlist)
102			#define ecb_is_constant(expr) 0
103			#define ecb_expect(expr,value) (expr)
104			#define ecb_prefetch(addr,rw,locality)
105	root	1.1	#endif
106
107	root	1.2	/* no emulation for ecb_decltype */
108	root	1.1	#if ECB_GCC_VERSION(4,5)
109	root	1.37	#define ecb_decltype(x) __decltype(x)
110	root	1.1	#elif ECB_GCC_VERSION(3,0)
111	root	1.39	#define ecb_decltype(x) __typeof(x)
112	root	1.1	#endif
113
114	root	1.24	#define ecb_noinline ecb_attribute ((__noinline__))
115			#define ecb_noreturn ecb_attribute ((__noreturn__))
116			#define ecb_unused ecb_attribute ((__unused__))
117			#define ecb_const ecb_attribute ((__const__))
118			#define ecb_pure ecb_attribute ((__pure__))
119	root	1.35
120			#if ECB_GCC_VERSION(4,3)
121	root	1.39	#define ecb_artificial ecb_attribute ((__artificial__))
122			#define ecb_hot ecb_attribute ((__hot__))
123			#define ecb_cold ecb_attribute ((__cold__))
124	root	1.35	#else
125			#define ecb_artificial
126			#define ecb_hot
127			#define ecb_cold
128			#endif
129	root	1.1
130	root	1.39	/* put around conditional expressions if you are very sure that the */
131			/* expression is mostly true or mostly false. note that these return */
132			/* booleans, not the expression. */
133	root	1.33	#define ecb_expect_false(expr) ecb_expect (!!(expr), 0)
134			#define ecb_expect_true(expr) ecb_expect (!!(expr), 1)
135	root	1.36	/* for compatibility to the rest of the world */
136	root	1.33	#define ecb_likely(expr) ecb_expect_true (expr)
137			#define ecb_unlikely(expr) ecb_expect_false (expr)
138	root	1.1
139	root	1.3	/* count trailing zero bits and count # of one bits */
140	root	1.1	#if ECB_GCC_VERSION(3,4)
141	root	1.35	#define ecb_ctz32(x) __builtin_ctz (x)
142			#define ecb_popcount32(x) __builtin_popcount (x)
143	root	1.1	#else
144	root	1.39	ecb_function_ int ecb_ctz32 (uint32_t x) ecb_const;
145			ecb_function_ int
146	root	1.35	ecb_ctz32 (uint32_t x)
147			{
148			int r = 0;
149
150	root	1.45	x &= (uint32_t)-(int32_t)x; /* this isolates the lowest bit */
151	root	1.35
152			if (x & 0xaaaaaaaa) r += 1;
153			if (x & 0xcccccccc) r += 2;
154			if (x & 0xf0f0f0f0) r += 4;
155			if (x & 0xff00ff00) r += 8;
156			if (x & 0xffff0000) r += 16;
157
158			return r;
159			}
160
161	root	1.39	ecb_function_ int ecb_popcount32 (uint32_t x) ecb_const;
162			ecb_function_ int
163	root	1.35	ecb_popcount32 (uint32_t x)
164			{
165			x -= (x >> 1) & 0x55555555;
166			x = ((x >> 2) & 0x33333333) + (x & 0x33333333);
167			x = ((x >> 4) + x) & 0x0f0f0f0f;
168			x *= 0x01010101;
169	root	1.1
170	root	1.35	return x >> 24;
171			}
172	root	1.1	#endif
173
174	root	1.13	#if ECB_GCC_VERSION(4,3)
175	root	1.35	#define ecb_bswap32(x) __builtin_bswap32 (x)
176			#define ecb_bswap16(x) (__builtin_bswap32(x) >> 16)
177	root	1.13	#else
178	root	1.39	ecb_function_ uint32_t ecb_bswap32 (uint32_t x) ecb_const;
179			ecb_function_ uint32_t
180	root	1.35	ecb_bswap32 (uint32_t x)
181			{
182			return (x >> 24)
183			\| ((x >> 8) & 0x0000ff00)
184			\| ((x << 8) & 0x00ff0000)
185			\| (x << 24);
186			}
187
188	root	1.39	ecb_function_ uint32_t ecb_bswap16 (uint32_t x) ecb_const;
189			ecb_function_ uint32_t
190	root	1.35	ecb_bswap16 (uint32_t x)
191			{
192			return ((x >> 8) & 0xff)
193			\| ((x << 8) & 0x00ff0000)
194			\| (x << 24);
195			}
196	root	1.13	#endif
197
198			#if ECB_GCC_VERSION(4,5)
199	root	1.35	#define ecb_unreachable() __builtin_unreachable ()
200	root	1.13	#else
201	root	1.35	/* this seems to work fine, but gcc always emits a warning for it :/ */
202	root	1.39	ecb_function_ void ecb_unreachable (void) ecb_noreturn;
203			ecb_function_ void ecb_unreachable (void) { }
204	root	1.13	#endif
205
206	root	1.41	/* try to tell the compiler that some condition is definitely true */
207			#define ecb_assume(cond) do { if (!(cond)) ecb_unreachable (); } while (0)
208
209	root	1.39	ecb_function_ unsigned char ecb_byteorder_helper (void) ecb_const;
210			ecb_function_ unsigned char
211	root	1.23	ecb_byteorder_helper (void)
212	root	1.3	{
213			const uint32_t u = 0x11223344;
214			return (unsigned char )&u;
215			}
216
217	root	1.39	ecb_function_ ecb_bool ecb_big_endian (void) ecb_const;
218	root	1.42	ecb_function_ ecb_bool ecb_big_endian (void) { return ecb_byteorder_helper () == 0x11; }
219	root	1.39	ecb_function_ ecb_bool ecb_little_endian (void) ecb_const;
220	root	1.42	ecb_function_ ecb_bool ecb_little_endian (void) { return ecb_byteorder_helper () == 0x44; }
221	root	1.3
222	root	1.39	#if ECB_GCC_VERSION(3,0) \|\| ECB_C99
223	root	1.35	#define ecb_mod(m,n) ((m) % (n) + ((m) % (n) < 0 ? (n) : 0))
224	root	1.31	#else
225	root	1.35	#define ecb_mod(m,n) ((m) < 0 ? ((n) - 1 - ((-1 - (m)) % (n))) : ((m) % (n)))
226	root	1.31	#endif
227	root	1.21
228	root	1.5	#if ecb_cplusplus_does_not_suck
229	root	1.40	/* does not work for local types (http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2657.htm) */
230	root	1.35	template<typename T, int N>
231			static inline int ecb_array_length (const T (&arr)[N])
232			{
233			return N;
234			}
235	root	1.5	#else
236	root	1.35	#define ecb_array_length(name) (sizeof (name) / sizeof (name [0]))
237	root	1.5	#endif
238
239	root	1.14	ECB_INLINE uint32_t ecb_rotr32 (uint32_t x, unsigned int count) ecb_const;
240	root	1.6	ECB_INLINE uint32_t
241	root	1.9	ecb_rotr32 (uint32_t x, unsigned int count)
242	root	1.6	{
243	root	1.9	return (x << (32 - count)) \| (x >> count);
244	root	1.6	}
245
246	root	1.14	ECB_INLINE uint32_t ecb_rotl32 (uint32_t x, unsigned int count) ecb_const;
247	root	1.6	ECB_INLINE uint32_t
248	root	1.9	ecb_rotl32 (uint32_t x, unsigned int count)
249	root	1.6	{
250	root	1.9	return (x >> (32 - count)) \| (x << count);
251	root	1.6	}
252
253	root	1.1	#endif
254