osMacros.h

00001 /*
00002  * Copyright (c) 1997-2009 Objective Systems, Inc.
00003  *
00004  * This software is furnished under a license and may be used and copied
00005  * only in accordance with the terms of such license and with the
00006  * inclusion of the above copyright notice. This software or any other
00007  * copies thereof may not be provided or otherwise made available to any
00008  * other person. No title to and ownership of the software is hereby
00009  * transferred.
00010  *
00011  * The information in this software is subject to change without notice
00012  * and should not be construed as a commitment by Objective Systems, Inc.
00013  *
00014  * PROPRIETARY NOTICE
00015  *
00016  * This software is an unpublished work subject to a confidentiality agreement
00017  * and is protected by copyright and trade secret law.  Unauthorized copying,
00018  * redistribution or other use of this work is prohibited.
00019  *
00020  * The above notice of copyright on this source code product does not indicate
00021  * any actual or intended publication of such source code.
00022  *
00023  *****************************************************************************/
00024 
00025 #ifndef _OSMACROS_H_
00026 #define _OSMACROS_H_
00027 
00028 #if defined(_MSC_VER)
00029 // this disables 'conditional expression is constant' warnings
00030 // caused by using do { ... } while(0) in defines.
00031 #pragma warning(disable: 4127)
00032 #endif
00033 
00034 /* Min/max tests */
00035 #define OS_MAX(a,b) (((a)>(b))?(a):(b))
00036 #define OS_MIN(a,b) (((a)<(b))?(a):(b))
00037 
00038 /* Test if character is a hex character */
00039 #define OS_ISHEXCHAR(c) \
00040 ((c >= '0' && c <= '9') || (c >= 'A' && c <= 'F') || (c >= 'a' && c <= 'f'))
00041 
00042 /* Test if string variable (const char*) is empty */
00043 #define OS_ISEMPTY(s) (s == 0 || *s == '\0')
00044 
00045 /* Nibble-to-hex char conversion macros */
00046 #define OS_HEXCHARTONIBBLE(ch,b) do { \
00047 if (ch >= '0' && ch <= '9') b = (unsigned char)(ch - '0'); \
00048 else if (ch >= 'a' && ch <= 'f') b = (unsigned char)((ch - 'a') + 10); \
00049 else if (ch >= 'A' && ch <= 'F') b = (unsigned char)((ch - 'A') + 10); \
00050 else b = 0xFF; } while(0)
00051 
00052 #define OS_NIBBLETOHEXCHAR(b,ch) do { \
00053 if (b >= 0 && b <= 9) ch = (char)(b + '0'); \
00054 else if (b >= 0x0a && b <= 0x0f) ch = (char)((b - 10)+ 'a'); \
00055 else ch = '?'; } while(0)
00056 
00062 #define OSRTARRAYSIZE(x) (sizeof(x)/sizeof(x[0]))
00063 
00067 #define OSUTF8(str) ((const OSUTF8CHAR*)str)
00068 
00072 #define OSUTF8LEN(str) strlen((const char*)str)
00073 
00074 /* Generic list iteration macros */
00075 
00076 #define ForAllIter(p,listIter,type) \
00077 for(listIter.setFirst(),p=(type)listIter.getCurrentItem();!listIter.isDone();\
00078 listIter.setNext(),p=(type)listIter.getCurrentItem())
00079 
00080 #define ForAllIterRev(p,listIter,type) \
00081 for(listIter.setLast(),p=(type)listIter.getCurrentItem();!listIter.isDone();\
00082 listIter.setPrev(),p=(type)listIter.getCurrentItem())
00083 
00084 /* UTF-8 character size for -static option */
00085 
00086 #define UTF8CHAR_SIZE 1
00087 
00088 /* snprintf macros */
00089 
00090 #include <stdio.h>
00091 #include <stdarg.h>
00092 
00093 #if defined(_MSC_VER)
00094 #  if _MSC_VER >= 1400
00095 #    define os_snprintf(str, size, ...) \
00096      _snprintf_s(str, size, _TRUNCATE, __VA_ARGS__)
00097 #    define os_vsnprintf(str, size, fmt, ...) \
00098      _vsnprintf_s(str, size, _TRUNCATE, fmt, __VA_ARGS__)
00099 #  else
00100 #    define os_snprintf _snprintf
00101 #    define os_vsnprintf _vsnprintf
00102 #  endif
00103 #elif defined(__HP_aCC)
00104 /* at least aCC on HP-UX 11 expects format as non-const! */
00105 #  define os_snprintf(str, size, ...) sprintf(str, __VA_ARGS__)
00106 #  define os_vsnprintf(str, size, fmt, ...) \
00107       vsnprintf(str, size, (char *)fmt, __VA_ARGS__)
00108 #elif defined(_NO_SNPRINTF_) && !defined(__vxworks) && !defined (__SYMBIAN32__)
00109 #define os_snprintf(str, size, ...) sprintf(str, __VA_ARGS__)
00110 #define os_vsnprintf(str, size, fmt, ...) vsprintf(str, fmt, __VA_ARGS__)
00111 /* We use gcc 2.95, which requires ##ARGS */
00112 #elif defined(__vxworks) || defined(__SYMBIAN32__)
00113 #define os_snprintf(str,size,ARGS...) sprintf(str,##ARGS)
00114 #define os_vsnprintf(str,size,fmt,ARGS...) vsprintf(str,fmt,##ARGS)
00115 #else
00116 #define os_snprintf snprintf
00117 #define os_vsnprintf vsnprintf
00118 #endif
00119 
00120 #endif
00121