File: cxmacros_8h_source.html

package info (click to toggle)
cpl 6.1.1-2
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 18,764 kB
  • sloc: ansic: 111,368; sh: 14,549; makefile: 626
file content (258 lines) | stat: -rw-r--r-- 19,311 bytes parent folder | download
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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>C Standard Library Extensions: cxmacros.h Source File</title>

<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />



</head>
<body>
<div id="top"><!-- do not remove this div! -->


<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  
  
  <td style="padding-left: 0.5em;">
   <div id="projectname">C Standard Library Extensions
   &#160;<span id="projectnumber">1.1</span>
   </div>
   
  </td>
  
  
  
 </tr>
 </tbody>
</table>
</div>

<!-- Generated by Doxygen 1.8.0 -->
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="dirs.html"><span>Directories</span></a></li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&#160;List</span></a></li>
    </ul>
  </div>
  <div id="nav-path" class="navpath">
    <ul>
      <li class="navelem"><a class="el" href="dir_c2959b2ad5731f3b356ab222d87e802c.html">cext</a>      </li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="headertitle">
<div class="title">cxmacros.h</div>  </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* $Id: cxmacros.h,v 1.7 2011/02/21 14:15:31 rpalsa Exp $</span>
<a name="l00002"></a>00002 <span class="comment"> *</span>
<a name="l00003"></a>00003 <span class="comment"> * This file is part of the ESO C Extension Library</span>
<a name="l00004"></a>00004 <span class="comment"> * Copyright (C) 2001-2011 European Southern Observatory</span>
<a name="l00005"></a>00005 <span class="comment"> *</span>
<a name="l00006"></a>00006 <span class="comment"> * This program is free software; you can redistribute it and/or modify</span>
<a name="l00007"></a>00007 <span class="comment"> * it under the terms of the GNU General Public License as published by</span>
<a name="l00008"></a>00008 <span class="comment"> * the Free Software Foundation; either version 2 of the License, or</span>
<a name="l00009"></a>00009 <span class="comment"> * (at your option) any later version.</span>
<a name="l00010"></a>00010 <span class="comment"> *</span>
<a name="l00011"></a>00011 <span class="comment"> * This program is distributed in the hope that it will be useful,</span>
<a name="l00012"></a>00012 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00013"></a>00013 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the</span>
<a name="l00014"></a>00014 <span class="comment"> * GNU General Public License for more details.</span>
<a name="l00015"></a>00015 <span class="comment"> *</span>
<a name="l00016"></a>00016 <span class="comment"> * You should have received a copy of the GNU General Public License</span>
<a name="l00017"></a>00017 <span class="comment"> * along with this program; if not, write to the Free Software</span>
<a name="l00018"></a>00018 <span class="comment"> * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA</span>
<a name="l00019"></a>00019 <span class="comment"> */</span>
<a name="l00020"></a>00020 
<a name="l00021"></a>00021 <span class="comment">/*</span>
<a name="l00022"></a>00022 <span class="comment"> * $Author: rpalsa $</span>
<a name="l00023"></a>00023 <span class="comment"> * $Date: 2011/02/21 14:15:31 $</span>
<a name="l00024"></a>00024 <span class="comment"> * $Revision: 1.7 $</span>
<a name="l00025"></a>00025 <span class="comment"> * $Name: cpl-6_1_1 $</span>
<a name="l00026"></a>00026 <span class="comment"> */</span>
<a name="l00027"></a>00027 
<a name="l00028"></a>00028 
<a name="l00029"></a>00029 <span class="comment">/*</span>
<a name="l00030"></a>00030 <span class="comment"> * This file MUST not include any other cext header file.</span>
<a name="l00031"></a>00031 <span class="comment"> */</span>
<a name="l00032"></a>00032 
<a name="l00033"></a>00033 <span class="preprocessor">#ifndef CX_MACROS_H</span>
<a name="l00034"></a>00034 <span class="preprocessor"></span><span class="preprocessor">#define CX_MACROS_H</span>
<a name="l00035"></a>00035 <span class="preprocessor"></span>
<a name="l00036"></a>00036 
<a name="l00037"></a>00037 <span class="comment">/*</span>
<a name="l00038"></a>00038 <span class="comment"> * Get the system&#39;s definition of NULL from stddef.h</span>
<a name="l00039"></a>00039 <span class="comment"> */</span>
<a name="l00040"></a>00040 
<a name="l00041"></a>00041 <span class="preprocessor">#include &lt;stddef.h&gt;</span>
<a name="l00042"></a>00042 
<a name="l00043"></a>00043 
<a name="l00044"></a>00044 <span class="comment">/*</span>
<a name="l00045"></a>00045 <span class="comment"> * An alias for __extension__</span>
<a name="l00046"></a>00046 <span class="comment"> */</span>
<a name="l00047"></a>00047 
<a name="l00048"></a>00048 <span class="preprocessor">#if __GNUC__ &gt; 2 || (__GNUC__ == 2 &amp;&amp; __GNUC_MINOR__ &gt;= 8)</span>
<a name="l00049"></a>00049 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_EXTENSION __extension__</span>
<a name="l00050"></a>00050 <span class="preprocessor"></span><span class="preprocessor">#else</span>
<a name="l00051"></a>00051 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_EXTENSION</span>
<a name="l00052"></a>00052 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00053"></a>00053 <span class="preprocessor"></span>
<a name="l00054"></a>00054 
<a name="l00055"></a>00055 <span class="comment">/*</span>
<a name="l00056"></a>00056 <span class="comment"> * Macros for the GNU compiler function attributes</span>
<a name="l00057"></a>00057 <span class="comment"> */</span>
<a name="l00058"></a>00058 
<a name="l00059"></a>00059 <span class="preprocessor">#if __GNUC__ &gt; 2 || (__GNUC__ == 2 &amp;&amp; __GNUC_MINOR__ &gt;= 96)</span>
<a name="l00060"></a>00060 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_PURE   __attribute__((__pure__))</span>
<a name="l00061"></a>00061 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_MALLOC __attribute__((__malloc__))</span>
<a name="l00062"></a>00062 <span class="preprocessor"></span><span class="preprocessor">#else</span>
<a name="l00063"></a>00063 <span class="preprocessor"></span><span class="preprocessor">#  define G_GNUC_PURE</span>
<a name="l00064"></a>00064 <span class="preprocessor"></span><span class="preprocessor">#  define G_GNUC_MALLOC</span>
<a name="l00065"></a>00065 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00066"></a>00066 <span class="preprocessor"></span>
<a name="l00067"></a>00067 <span class="preprocessor">#if __GNUC__ &gt; 2 || (__GNUC__ == 2 &amp;&amp; __GNUC_MINOR__ &gt; 4)</span>
<a name="l00068"></a>00068 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_PRINTF(fmt_idx, arg_idx) \</span>
<a name="l00069"></a>00069 <span class="preprocessor">          __attribute__((__format__ (__printf__, fmt_idx, arg_idx)))</span>
<a name="l00070"></a>00070 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_SCANF(fmt_idx, arg_idx)  \</span>
<a name="l00071"></a>00071 <span class="preprocessor">          __attribute__((__format__ (__scanf__, fmt_idx, arg_idx)))</span>
<a name="l00072"></a>00072 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_FORMAT(arg_idx) __attribute__((__format_arg__ (arg_idx)))</span>
<a name="l00073"></a>00073 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_NORETURN        __attribute__((__noreturn__))</span>
<a name="l00074"></a>00074 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_CONST           __attribute__((__const__))</span>
<a name="l00075"></a>00075 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_UNUSED          __attribute__((__unused__))</span>
<a name="l00076"></a>00076 <span class="preprocessor"></span><span class="preprocessor">#else</span>
<a name="l00077"></a>00077 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_PRINTF(fmt_idx, arg_idx)</span>
<a name="l00078"></a>00078 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_SCANF(fmt_idx, arg_idx)</span>
<a name="l00079"></a>00079 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_FORMAT(arg_idx)</span>
<a name="l00080"></a>00080 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_NORETURN</span>
<a name="l00081"></a>00081 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_CONST</span>
<a name="l00082"></a>00082 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_UNUSED</span>
<a name="l00083"></a>00083 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00084"></a>00084 <span class="preprocessor"></span>
<a name="l00085"></a>00085 
<a name="l00086"></a>00086 <span class="comment">/*</span>
<a name="l00087"></a>00087 <span class="comment"> * Wrap the gcc __PRETTY_FUNCTION__ and __FUNCTION__ variables with macros.</span>
<a name="l00088"></a>00088 <span class="comment"> */</span>
<a name="l00089"></a>00089 
<a name="l00090"></a>00090 <span class="preprocessor">#if defined (__GNUC__) &amp;&amp; (__GNUC__ &lt; 3)</span>
<a name="l00091"></a>00091 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_FUNCTION         __FUNCTION__</span>
<a name="l00092"></a>00092 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_PRETTY_FUNCTION  __PRETTY_FUNCTION__</span>
<a name="l00093"></a>00093 <span class="preprocessor"></span><span class="preprocessor">#else </span><span class="comment">/* !__GNUC__ */</span>
<a name="l00094"></a>00094 <span class="preprocessor">#  define CX_GNUC_FUNCTION         &quot;&quot;</span>
<a name="l00095"></a>00095 <span class="preprocessor"></span><span class="preprocessor">#  define CX_GNUC_PRETTY_FUNCTION  &quot;&quot;</span>
<a name="l00096"></a>00096 <span class="preprocessor"></span><span class="preprocessor">#endif </span><span class="comment">/* !__GNUC__ */</span>
<a name="l00097"></a>00097 
<a name="l00098"></a>00098 <span class="preprocessor">#define CX_STRINGIFY(macro)         CX_STRINGIFY_ARG(macro)</span>
<a name="l00099"></a>00099 <span class="preprocessor"></span><span class="preprocessor">#define CX_STRINGIFY_ARG(contents)  #contents</span>
<a name="l00100"></a>00100 <span class="preprocessor"></span>
<a name="l00101"></a>00101 
<a name="l00102"></a>00102 <span class="comment">/*</span>
<a name="l00103"></a>00103 <span class="comment"> * String identifier for the current code position</span>
<a name="l00104"></a>00104 <span class="comment"> */</span>
<a name="l00105"></a>00105 
<a name="l00106"></a>00106 <span class="preprocessor">#if defined (__GNUC__) &amp;&amp; (__GNUC__ &lt; 3)</span>
<a name="l00107"></a>00107 <span class="preprocessor"></span><span class="preprocessor">#  define CX_CODE_POS  __FILE__ &quot;:&quot; CX_STRINGIFY(__LINE__) &quot;:&quot; __PRETTY_FUNCTION__ &quot;()&quot;</span>
<a name="l00108"></a>00108 <span class="preprocessor"></span><span class="preprocessor">#else</span>
<a name="l00109"></a>00109 <span class="preprocessor"></span><span class="preprocessor">#  define CX_CODE_POS  __FILE__ &quot;:&quot; CX_STRINGIFY(__LINE__)</span>
<a name="l00110"></a>00110 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00111"></a>00111 <span class="preprocessor"></span>
<a name="l00112"></a>00112 
<a name="l00113"></a>00113 <span class="comment">/*</span>
<a name="l00114"></a>00114 <span class="comment"> * Current function identifier</span>
<a name="l00115"></a>00115 <span class="comment"> */</span>
<a name="l00116"></a>00116 <span class="preprocessor">#if defined (__GNUC__)</span>
<a name="l00117"></a>00117 <span class="preprocessor"></span><span class="preprocessor">#  define CX_FUNC_NAME  ((const char*) (__PRETTY_FUNCTION__))</span>
<a name="l00118"></a>00118 <span class="preprocessor"></span><span class="preprocessor">#elif defined (__STDC_VERSION__) &amp;&amp; __STDC_VERSION__ &gt;= 19901L</span>
<a name="l00119"></a>00119 <span class="preprocessor"></span><span class="preprocessor">#  define CX_FUNC_NAME  ((const char*) (__func__))</span>
<a name="l00120"></a>00120 <span class="preprocessor"></span><span class="preprocessor">#else</span>
<a name="l00121"></a>00121 <span class="preprocessor"></span><span class="preprocessor">#  define CX_FUNC_NAME  ((const char*) (&quot;???&quot;))</span>
<a name="l00122"></a>00122 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00123"></a>00123 <span class="preprocessor"></span>
<a name="l00124"></a>00124 
<a name="l00125"></a>00125 <span class="comment">/*</span>
<a name="l00126"></a>00126 <span class="comment"> * C code guard</span>
<a name="l00127"></a>00127 <span class="comment"> */</span>
<a name="l00128"></a>00128 
<a name="l00129"></a>00129 <span class="preprocessor">#undef CX_BEGIN_DECLS</span>
<a name="l00130"></a>00130 <span class="preprocessor"></span><span class="preprocessor">#undef CX_END_DECLS</span>
<a name="l00131"></a>00131 <span class="preprocessor"></span>
<a name="l00132"></a>00132 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00133"></a>00133 <span class="preprocessor"></span><span class="preprocessor">#  define CX_BEGIN_DECLS  extern &quot;C&quot; {</span>
<a name="l00134"></a>00134 <span class="preprocessor"></span><span class="preprocessor">#  define CX_END_DECLS    }</span>
<a name="l00135"></a>00135 <span class="preprocessor"></span><span class="preprocessor">#else</span>
<a name="l00136"></a>00136 <span class="preprocessor"></span><span class="preprocessor">#  define CX_BEGIN_DECLS  </span><span class="comment">/* empty */</span>
<a name="l00137"></a>00137 <span class="preprocessor">#  define CX_END_DECLS    </span><span class="comment">/* empty */</span>
<a name="l00138"></a>00138 <span class="preprocessor">#endif</span>
<a name="l00139"></a>00139 <span class="preprocessor"></span>
<a name="l00140"></a>00140 
<a name="l00141"></a>00141 <span class="comment">/*</span>
<a name="l00142"></a>00142 <span class="comment"> * Some popular macros. If the system provides already a definition for some</span>
<a name="l00143"></a>00143 <span class="comment"> * of them this definition is used, assuming the definition is correct.</span>
<a name="l00144"></a>00144 <span class="comment"> */</span>
<a name="l00145"></a>00145 
<a name="l00146"></a>00146 <span class="preprocessor">#ifndef NULL</span>
<a name="l00147"></a>00147 <span class="preprocessor"></span><span class="preprocessor">#  ifdef __cplusplus</span>
<a name="l00148"></a>00148 <span class="preprocessor"></span><span class="preprocessor">#    define NULL  (0L)</span>
<a name="l00149"></a>00149 <span class="preprocessor"></span><span class="preprocessor">#  else </span><span class="comment">/* !__cplusplus */</span>
<a name="l00150"></a>00150 <span class="preprocessor">#    define NULL  ((void *) 0)</span>
<a name="l00151"></a>00151 <span class="preprocessor"></span><span class="preprocessor">#  endif </span><span class="comment">/* !__cplusplus */</span>
<a name="l00152"></a>00152 <span class="preprocessor">#endif</span>
<a name="l00153"></a>00153 <span class="preprocessor"></span>
<a name="l00154"></a>00154 <span class="preprocessor">#ifndef FALSE</span>
<a name="l00155"></a>00155 <span class="preprocessor"></span><span class="preprocessor">#  define FALSE  (0)</span>
<a name="l00156"></a>00156 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00157"></a>00157 <span class="preprocessor"></span>
<a name="l00158"></a>00158 <span class="preprocessor">#ifndef TRUE</span>
<a name="l00159"></a>00159 <span class="preprocessor"></span><span class="preprocessor">#  define TRUE  (!FALSE)</span>
<a name="l00160"></a>00160 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00161"></a>00161 <span class="preprocessor"></span>
<a name="l00162"></a>00162 <span class="preprocessor">#ifndef CX_MIN</span>
<a name="l00163"></a>00163 <span class="preprocessor"></span><span class="preprocessor"># define CX_MIN(a, b)  ((a) &lt; (b) ? (a) : (b))</span>
<a name="l00164"></a>00164 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00165"></a>00165 <span class="preprocessor"></span>
<a name="l00166"></a>00166 <span class="preprocessor">#ifndef CX_MAX</span>
<a name="l00167"></a>00167 <span class="preprocessor"></span><span class="preprocessor"># define CX_MAX(a, b)  ((a) &gt; (b) ? (a) : (b))</span>
<a name="l00168"></a>00168 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00169"></a>00169 <span class="preprocessor"></span>
<a name="l00170"></a>00170 <span class="preprocessor">#ifndef CX_ABS</span>
<a name="l00171"></a>00171 <span class="preprocessor"></span><span class="preprocessor"># define CX_ABS(a)  ((a) &lt; (0) ? -(a) : (a))</span>
<a name="l00172"></a>00172 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00173"></a>00173 <span class="preprocessor"></span>
<a name="l00174"></a>00174 <span class="preprocessor">#ifndef CX_CLAMP</span>
<a name="l00175"></a>00175 <span class="preprocessor"></span><span class="preprocessor"># define CX_CLAMP(a, low, high)  (((a) &gt; (high)) ? (high) : (((a) &lt; (low)) ? (low) : (a)))</span>
<a name="l00176"></a>00176 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00177"></a>00177 <span class="preprocessor"></span>
<a name="l00178"></a>00178 
<a name="l00179"></a>00179 <span class="comment">/*</span>
<a name="l00180"></a>00180 <span class="comment"> * Number of elements in an array</span>
<a name="l00181"></a>00181 <span class="comment"> */</span>
<a name="l00182"></a>00182 
<a name="l00183"></a>00183 <span class="preprocessor">#define CX_N_ELEMENTS(array)  (sizeof (array) / sizeof ((array)[0]))</span>
<a name="l00184"></a>00184 <span class="preprocessor"></span>
<a name="l00185"></a>00185 <span class="preprocessor">#endif </span><span class="comment">/* CX_MACROS_H */</span>
</pre></div></div><!-- contents -->


<hr class="footer"/><address class="footer"><small>
Generated on Tue May 22 2012 06:56:06 for C Standard Library Extensions by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.0
</small></address>

</body>
</html>