5 Author: Pekka Riikonen <priikone@silcnet.org>
7 Copyright (C) 2002 - 2007 Pekka Riikonen
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; version 2 of the License.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
20 /****h* silcutil/SILC Types
24 * This header includes the most basic types used in the SILC source
25 * tree, such as arithmetic types and their manipulation macros. This
26 * file is included in the silcincludes.h and is automatically available
34 /****d* silcutil/SILCTypes/SilcBool
38 * typedef unigned char SilcBool;
42 * Boolean value, and is always 8-bits. Represents value 0 or 1.
45 typedef unsigned char SilcBool;
47 /* The bool macro is deprecated. Use SilcBool instead. */
53 #define bool unsigned char
57 /****d* silcutil/SILCTypes/TRUE
65 * Boolean true value indicator.
74 /****d* silcutil/SILCTypes/FALSE
82 * Boolean false value indicator.
91 /* Our offsetof macro */
92 #define silc_offsetof(TYPE, MEMBER) ((size_t) &((TYPE *)0)->MEMBER)
94 /* silc_likely and silc_unlikely GCC branch prediction macros. Use only if
95 you have profiled the code first. */
97 #define silc_likely(expr) __builtin_expect(!!(expr), 1)
98 #define silc_unlikely(expr) __builtin_expect(!!(expr), 0)
100 #define silc_likely(expr) (expr)
101 #define silc_unlikely(expr) (expr)
102 #endif /* __GNUC__ >= 3 */
104 #if SILC_SIZEOF_SHORT > 2
105 #error "size of the short must be 2 bytes"
108 /****d* silcutil/SILCTypes/SilcUInt8
112 * typedef unsigned char SilcUInt8;
116 * 8-bit unsigned integer.
120 typedef unsigned char SilcUInt8;
123 /****d* silcutil/SILCTypes/SilcInt8
127 * typedef signed char SilcInt8;
131 * 8-bit signed integer.
135 typedef signed char SilcInt8;
138 /****d* silcutil/SILCTypes/SilcUInt16
142 * typedef unsigned short SilcUInt16;
146 * 16-bit unsigned integer. Guaranteed to be 16-bits.
150 typedef unsigned short SilcUInt16;
153 /****d* silcutil/SILCTypes/SilcInt16
157 * typedef signed short SilcInt16;
161 * 16-bit signed integer. Guaranteed to be 16-bits.
165 typedef signed short SilcInt16;
168 /****d* silcutil/SILCTypes/SilcUInt32
172 * typedef unsigned long SilcUInt32;
176 * 32-bit unsigned integer. Guaranteed to be 32-bits.
180 #if SILC_SIZEOF_LONG == 4
181 typedef unsigned long SilcUInt32;
182 typedef signed long SilcInt32;
184 #if SILC_SIZEOF_INT == 4
185 typedef unsigned int SilcUInt32;
186 typedef signed int SilcInt32;
188 #if SILC_SIZEOF_LONG_LONG >= 4
190 typedef unsigned long long SilcUInt32;
191 typedef signed long long SilcInt32;
198 /****d* silcutil/SILCTypes/SilcInt32
202 * typedef signed long SilcInt32;
206 * 32-bit signed integer. Guaranteed to be 32-bits.
210 /****d* silcutil/SILCTypes/SilcUInt64
214 * typedef unsigned long long SilcUInt64;
218 * 64-bit unsigned integer. Guaranteed to be 64-bits on systems that
223 #if SILC_SIZEOF_LONG >= 8
224 typedef unsigned long SilcUInt64;
225 typedef signed long SilcInt64;
227 #if SILC_SIZEOF_LONG_LONG >= 8
229 typedef unsigned long long SilcUInt64;
230 typedef signed long long SilcInt64;
232 typedef unsigned __int64 SilcUInt64;
233 typedef signed __int64 SilcInt64;
236 typedef SilcUInt32 SilcUInt64;
237 typedef SilcInt32 SilcInt64;
242 /****d* silcutil/SILCTypes/SilcInt64
246 * typedef signed long long SilcInt64;
250 * 64-bit signed integer. Guaranteed to be 64-bits on systems that
255 #if SILC_SIZEOF_VOID_P < 4
256 typedef SilcUInt32 * void *;
259 /****d* silcutil/SILCTypes/SilcSocket
267 * Platform specific socket. On POSIX compliant systems this is simply
268 * an integer, representing the socket. On other systems it is platform
269 * specific socket context. Access it only through routines that can
270 * handle SilcSocket types, unless you know what you are doing.
274 #if defined(SILC_UNIX) || defined(SILC_WIN32)
275 typedef int SilcSocket;
276 #elif defined(SILC_SYMBIAN)
277 typedef void * SilcSocket;
283 #define SILC_GET_WORD(cp) ((SilcUInt32)(SilcUInt8)(cp)[0]) << 24 \
284 | ((SilcUInt32)(SilcUInt8)(cp)[1] << 16) \
285 | ((SilcUInt32)(SilcUInt8)(cp)[2] << 8) \
286 | ((SilcUInt32)(SilcUInt8)(cp)[3])
288 /****d* silcutil/SILCTypes/SILC_GET16_MSB
292 * #define SILC_GET16_MSB ...
296 * Return two 8-bit bytes, most significant bytes first.
300 #define SILC_GET16_MSB(l, cp) \
302 (l) = ((SilcUInt32)(SilcUInt8)(cp)[0] << 8) \
303 | ((SilcUInt32)(SilcUInt8)(cp)[1]); \
307 /****d* silcutil/SILCTypes/SILC_GET32_MSB
311 * #define SILC_GET32_MSB ...
315 * Return four 8-bit bytes, most significant bytes first.
319 #define SILC_GET32_MSB(l, cp) \
321 (l) = ((SilcUInt32)(SilcUInt8)(cp)[0]) << 24 \
322 | ((SilcUInt32)(SilcUInt8)(cp)[1] << 16) \
323 | ((SilcUInt32)(SilcUInt8)(cp)[2] << 8) \
324 | ((SilcUInt32)(SilcUInt8)(cp)[3]); \
328 /****d* silcutil/SILCTypes/SILC_GET64_MSB
332 * #define SILC_GET64_MSB ...
336 * Return eight 8-bit bytes, most significant bytes first.
340 #define SILC_GET64_MSB(l, cp) \
342 (l) = ((((SilcUInt64)SILC_GET_WORD((cp))) << 32) | \
343 ((SilcUInt64)SILC_GET_WORD((cp) + 4))); \
347 /****d* silcutil/SILCTypes/SILC_GET16_LSB
351 * #define SILC_GET16_MSB ...
355 * Return two 8-bit bytes, least significant bytes first.
359 #if defined(SILC_I486) && defined(__GNUC__)
360 #define SILC_GET16_LSB(l, cp) (l) = (*(SilcUInt16 *)(cp))
362 #define SILC_GET16_LSB(l, cp) \
364 (l) = ((SilcUInt32)(SilcUInt8)(cp)[0]) \
365 | ((SilcUInt32)(SilcUInt8)(cp)[1] << 8); \
367 #endif /* SILC_I486 && __GNUC__ */
370 /****d* silcutil/SILCTypes/SILC_GET32_LSB
374 * #define SILC_GET32_LSB ...
378 * Return four 8-bit bytes, least significant bytes first.
382 #if defined(SILC_I486) && defined(__GNUC__)
383 #define SILC_GET32_LSB(l, cp) (l) = (*(SilcUInt32 *)(cp))
385 #define SILC_GET32_LSB(l, cp) \
387 (l) = ((SilcUInt32)(SilcUInt8)(cp)[0]) \
388 | ((SilcUInt32)(SilcUInt8)(cp)[1] << 8) \
389 | ((SilcUInt32)(SilcUInt8)(cp)[2] << 16) \
390 | ((SilcUInt32)(SilcUInt8)(cp)[3] << 24); \
392 #endif /* SILC_I486 && __GNUC__ */
394 /* Same as upper but XOR the result always. Special purpose macro. */
395 #if defined(SILC_I486) && defined(__GNUC__)
396 #define SILC_GET32_X_LSB(l, cp) (l) ^= (*(SilcUInt32 *)(cp))
398 #define SILC_GET32_X_LSB(l, cp) \
399 (l) ^= ((SilcUInt32)(SilcUInt8)(cp)[0]) \
400 | ((SilcUInt32)(SilcUInt8)(cp)[1] << 8) \
401 | ((SilcUInt32)(SilcUInt8)(cp)[2] << 16) \
402 | ((SilcUInt32)(SilcUInt8)(cp)[3] << 24)
403 #endif /* SILC_I486 && __GNUC__ */
406 /****d* silcutil/SILCTypes/SILC_PUT16_MSB
410 * #define SILC_PUT16_MSB ...
414 * Put two 8-bit bytes, most significant bytes first.
418 #define SILC_PUT16_MSB(l, cp) \
420 (cp)[0] = (SilcUInt8)((l) >> 8); \
421 (cp)[1] = (SilcUInt8)(l); \
425 /****d* silcutil/SILCTypes/SILC_PUT32_MSB
429 * #define SILC_PUT32_MSB ...
433 * Put four 8-bit bytes, most significant bytes first.
437 #define SILC_PUT32_MSB(l, cp) \
439 (cp)[0] = (SilcUInt8)((l) >> 24); \
440 (cp)[1] = (SilcUInt8)((l) >> 16); \
441 (cp)[2] = (SilcUInt8)((l) >> 8); \
442 (cp)[3] = (SilcUInt8)(l); \
446 /****d* silcutil/SILCTypes/SILC_PUT64_MSB
450 * #define SILC_PUT64_MSB ...
454 * Put eight 8-bit bytes, most significant bytes first.
458 #define SILC_PUT64_MSB(l, cp) \
460 SILC_PUT32_MSB((SilcUInt32)((SilcUInt64)(l) >> 32), (cp)); \
461 SILC_PUT32_MSB((SilcUInt32)(l), (cp) + 4); \
465 /****d* silcutil/SILCTypes/SILC_PUT16_LSB
469 * #define SILC_PUT16_LSB ...
473 * Put two 8-bit bytes, least significant bytes first.
477 #if defined(SILC_I486) && defined(__GNUC__)
478 #define SILC_PUT16_LSB(l, cp) (*(SilcUInt16 *)(cp)) = (l)
480 #define SILC_PUT16_LSB(l, cp) \
482 (cp)[0] = (SilcUInt8)(l); \
483 (cp)[1] = (SilcUInt8)((l) >> 8); \
485 #endif /* SILC_I486 && __GNUC__ */
488 /****d* silcutil/SILCTypes/SILC_PUT32_LSB
492 * #define SILC_PUT32_LSB ...
496 * Put four 8-bit bytes, least significant bytes first.
500 #if defined(SILC_I486) && defined(__GNUC__)
501 #define SILC_PUT32_LSB(l, cp) (*(SilcUInt32 *)(cp)) = (l)
503 #define SILC_PUT32_LSB(l, cp) \
505 (cp)[0] = (SilcUInt8)(l); \
506 (cp)[1] = (SilcUInt8)((l) >> 8); \
507 (cp)[2] = (SilcUInt8)((l) >> 16); \
508 (cp)[3] = (SilcUInt8)((l) >> 24); \
510 #endif /* SILC_I486 && __GNUC__ */
513 /****d* silcutil/SILCTypes/SILC_SWAB_16
517 * #define SILC_SWAB_16 ...
521 * Swabs 16-bit unsigned integer byte order.
525 #define SILC_SWAB_16(l) \
526 ((SilcUInt16)(((SilcUInt16)(l) & (SilcUInt16)0x00FFU) << 8) | \
527 (((SilcUInt16)(l) & (SilcUInt16)0xFF00U) >> 8))
530 /****d* silcutil/SILCTypes/SILC_SWAB_32
534 * #define SILC_SWAB_32 ...
538 * Swabs 32-bit unsigned integer byte order.
542 #define SILC_SWAB_32(l) \
543 ((SilcUInt32)(((SilcUInt32)(l) & (SilcUInt32)0x000000FFUL) << 24) | \
544 (((SilcUInt32)(l) & (SilcUInt32)0x0000FF00UL) << 8) | \
545 (((SilcUInt32)(l) & (SilcUInt32)0x00FF0000UL) >> 8) | \
546 (((SilcUInt32)(l) & (SilcUInt32)0xFF000000UL) >> 24))
549 /****d* silcutil/SILCTypes/SILC_PTR_TO_32
553 * #define SILC_PTR_TO_32 ...
557 * Type casts a pointer's value into a 32-bit integer. Use this to
558 * avoid compiler warnings when type casting pointers to integers
563 #if SILC_SIZEOF_VOID_P < 8
564 #define SILC_PTR_TO_32(_ptr__) ((SilcUInt32)(_ptr__))
566 #define SILC_PTR_TO_32(_ptr__) \
567 ((SilcUInt32)((SilcUInt64)(_ptr__) & (SilcUInt32)0xFFFFFFFFUL))
571 /****d* silcutil/SILCTypes/SILC_PTR_TO_64
575 * #define SILC_PTR_TO_64 ...
579 * Type casts a pointer's value into a 64-bit integer. Use this to
580 * avoid compiler warnings when type casting pointers to integers
585 #if SILC_SIZEOF_VOID_P < 8
586 #define SILC_PTR_TO_64(_ptr__) ((SilcUInt64)((SilcUInt32)(_ptr__)))
588 #define SILC_PTR_TO_64(_ptr__) ((SilcUInt64)((SilcUInt64)(_ptr__)))
592 /****d* silcutil/SILCTypes/SILC_32_TO_PTR
596 * #define SILC_32_TO_PTR ...
600 * Type casts a 32-bit integer value into a pointer. Use this to
601 * avoid compiler warnings when type casting integers to pointers of
606 #if SILC_SIZEOF_VOID_P < 8
607 #define SILC_32_TO_PTR(_ival__) ((void *)((SilcUInt32)(_ival__)))
609 #define SILC_32_TO_PTR(_ival__) ((void *)((SilcUInt64)(_ival__)))
613 /****d* silcutil/SILCTypes/SILC_64_TO_PTR
617 * #define SILC_64_TO_PTR ...
621 * Type casts a 64-bit integer value into a pointer. Use this to
622 * avoid compiler warnings when type casting integers to pointers of
627 #if SILC_SIZEOF_VOID_P < 8
628 #define SILC_64_TO_PTR(_ival__) \
629 ((void *)((SilcUInt32)((SilcUInt64)(_ival__) & (SilcUInt32)0xFFFFFFFFUL)))
631 #define SILC_64_TO_PTR(_ival__) ((void *)((SilcUInt64)(_ival__)))
635 #endif /* SILCTYPES_H */