Debian Codegraph @

docs/reference/libxfce4windowingui/html/libxfce4windowingui-Library-Configuration.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>Library Configuration: libxfce4windowing Reference Manual</title>
6 <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
7 <link rel="home" href="index.html" title="libxfce4windowing Reference Manual">
8 <link rel="up" href="ch01.html" title="[Insert title here]">
9 <link rel="prev" href="ch01.html" title="[Insert title here]">
10 <link rel="next" href="XfwWindowActionMenu.html" title="XfwWindowActionMenu">
11 <meta name="generator" content="GTK-Doc V1.34.0 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts">
17 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18 <a href="#libxfce4windowingui-Library-Configuration.description" class="shortcut">Description</a></span>
19 </td>
20 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
21 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
22 <td><a accesskey="p" href="ch01.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
23 <td><a accesskey="n" href="XfwWindowActionMenu.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
24 </tr></table>
25 <div class="refentry">
26 <a name="libxfce4windowingui-Library-Configuration"></a><div class="titlepage"></div>
27 <div class="refnamediv"><table width="100%"><tr>
28 <td valign="top">
29 <h2><span class="refentrytitle"><a name="libxfce4windowingui-Library-Configuration.top_of_page"></a>Library Configuration</span></h2>
30 <p>Library Configuration — libxfce4windowingui config macros</p>
31 </td>
32 <td class="gallery_image" valign="top" align="right"></td>
33 </tr></table></div>
34 <div class="refsect1">
35 <a name="libxfce4windowingui-Library-Configuration.stability-level"></a><h2>Stability Level</h2>
36 <acronym title="The intention of a Stable interface is to enable arbitrary third parties to
37 develop applications to these interfaces, release them, and have confidence that
38 they will run on all minor releases of the product (after the one in which the
39 interface was introduced, and within the same major release). Even at a major
40 release, incompatible changes are expected to be rare, and to have strong
41 justifications.
42 "><span class="acronym">Stable</span></acronym>, unless otherwise indicated
43 </div>
44 <div class="refsect1">
45 <a name="libxfce4windowingui-Library-Configuration.functions"></a><h2>Functions</h2>
46 <div class="informaltable"><table class="informaltable" width="100%" border="0">
47 <colgroup>
48 <col width="150px" class="functions_proto_type">
49 <col class="functions_proto_name">
50 </colgroup>
51 <tbody>
52 <tr>
53 <td class="define_keyword">#define</td>
54 <td class="function_name">
55 <a class="link" href="libxfce4windowingui-Library-Configuration.html#LIBXFCE4WINDOWINGUI-CHECK-VERSION:CAPS" title="LIBXFCE4WINDOWINGUI_CHECK_VERSION()">LIBXFCE4WINDOWINGUI_CHECK_VERSION</a><span class="c_punctuation">()</span>
56 </td>
57 </tr>
58 <tr>
59 <td class="function_type">const <span class="returnvalue">gchar</span> *
60 </td>
61 <td class="function_name">
62 <a class="link" href="libxfce4windowingui-Library-Configuration.html#libxfce4windowingui-check-version" title="libxfce4windowingui_check_version ()">libxfce4windowingui_check_version</a> <span class="c_punctuation">()</span>
63 </td>
64 </tr>
65 </tbody>
66 </table></div>
67 </div>
68 <div class="refsect1">
69 <a name="libxfce4windowingui-Library-Configuration.other"></a><h2>Types and Values</h2>
70 <div class="informaltable"><table class="informaltable" width="100%" border="0">
71 <colgroup>
72 <col width="150px" class="other_proto_type">
73 <col class="other_proto_name">
74 </colgroup>
75 <tbody>
76 <tr>
77 <td class="define_keyword">#define</td>
78 <td class="function_name"><a class="link" href="libxfce4windowingui-Library-Configuration.html#LIBXFCE4WINDOWINGUI-MAJOR-VERSION:CAPS" title="LIBXFCE4WINDOWINGUI_MAJOR_VERSION">LIBXFCE4WINDOWINGUI_MAJOR_VERSION</a></td>
79 </tr>
80 <tr>
81 <td class="define_keyword">#define</td>
82 <td class="function_name"><a class="link" href="libxfce4windowingui-Library-Configuration.html#LIBXFCE4WINDOWINGUI-MINOR-VERSION:CAPS" title="LIBXFCE4WINDOWINGUI_MINOR_VERSION">LIBXFCE4WINDOWINGUI_MINOR_VERSION</a></td>
83 </tr>
84 <tr>
85 <td class="define_keyword">#define</td>
86 <td class="function_name"><a class="link" href="libxfce4windowingui-Library-Configuration.html#LIBXFCE4WINDOWINGUI-MICRO-VERSION:CAPS" title="LIBXFCE4WINDOWINGUI_MICRO_VERSION">LIBXFCE4WINDOWINGUI_MICRO_VERSION</a></td>
87 </tr>
88 <tr>
89 <td class="variable_type">extern const guint </td>
90 <td class="function_name"><a class="link" href="libxfce4windowingui-Library-Configuration.html#libxfce4windowingui-major-version" title="libxfce4windowingui_major_version">libxfce4windowingui_major_version</a></td>
91 </tr>
92 <tr>
93 <td class="variable_type">extern const guint </td>
94 <td class="function_name"><a class="link" href="libxfce4windowingui-Library-Configuration.html#libxfce4windowingui-micro-version" title="libxfce4windowingui_micro_version">libxfce4windowingui_micro_version</a></td>
95 </tr>
96 <tr>
97 <td class="variable_type">extern const guint </td>
98 <td class="function_name"><a class="link" href="libxfce4windowingui-Library-Configuration.html#libxfce4windowingui-minor-version" title="libxfce4windowingui_minor_version">libxfce4windowingui_minor_version</a></td>
99 </tr>
100 </tbody>
101 </table></div>
102 </div>
103 <div class="refsect1">
104 <a name="libxfce4windowingui-Library-Configuration.includes"></a><h2>Includes</h2>
105 <pre class="synopsis">#include &lt;libxfce4windowingui/libxfce4windowingui.h&gt;
106 </pre>
107 </div>
108 <div class="refsect1">
109 <a name="libxfce4windowingui-Library-Configuration.description"></a><h2>Description</h2>
110 <p>Variables and functions to check the libxfce4windowingui version.</p>
111 </div>
112 <div class="refsect1">
113 <a name="libxfce4windowingui-Library-Configuration.functions_details"></a><h2>Functions</h2>
114 <div class="refsect2">
115 <a name="LIBXFCE4WINDOWINGUI-CHECK-VERSION:CAPS"></a><h3>LIBXFCE4WINDOWINGUI_CHECK_VERSION()</h3>
116 <pre class="programlisting">#define LIBXFCE4WINDOWINGUI_CHECK_VERSION(major, minor, micro)</pre>
117 <p>A macro to compare libxfce4windowingui versions to determine if a particular
118 function is available.</p>
119 <div class="refsect3">
120 <a name="LIBXFCE4WINDOWINGUI-CHECK-VERSION.parameters"></a><h4>Parameters</h4>
121 <div class="informaltable"><table class="informaltable" width="100%" border="0">
122 <colgroup>
123 <col width="150px" class="parameters_name">
124 <col class="parameters_description">
125 <col width="200px" class="parameters_annotations">
126 </colgroup>
127 <tbody>
128 <tr>
129 <td class="parameter_name"><p>major</p></td>
130 <td class="parameter_description"><p>The major version of the library, i.e. 4</p></td>
131 <td class="parameter_annotations"> </td>
132 </tr>
133 <tr>
134 <td class="parameter_name"><p>minor</p></td>
135 <td class="parameter_description"><p>The minor version of the library, i.e. 18</p></td>
136 <td class="parameter_annotations"> </td>
137 </tr>
138 <tr>
139 <td class="parameter_name"><p>micro</p></td>
140 <td class="parameter_description"><p>The micro release of the library, i.e. 0</p></td>
141 <td class="parameter_annotations"> </td>
142 </tr>
143 </tbody>
144 </table></div>
145 </div>
146 </div>
147 <hr>
148 <div class="refsect2">
149 <a name="libxfce4windowingui-check-version"></a><h3>libxfce4windowingui_check_version ()</h3>
150 <pre class="programlisting">const <span class="returnvalue">gchar</span> *
151 libxfce4windowingui_check_version (<em class="parameter"><code><span class="type">guint</span> required_major</code></em>,
152 <em class="parameter"><code><span class="type">guint</span> required_minor</code></em>,
153 <em class="parameter"><code><span class="type">guint</span> required_micro</code></em>);</pre>
154 <p>Checks that the libxfce4windowingui library
155 in use is compatible with the given version. Generally you would pass in
156 the constants <a class="link" href="libxfce4windowingui-Library-Configuration.html#LIBXFCE4WINDOWINGUI-MAJOR-VERSION:CAPS" title="LIBXFCE4WINDOWINGUI_MAJOR_VERSION"><span class="type">LIBXFCE4WINDOWINGUI_MAJOR_VERSION</span></a>, <a class="link" href="libxfce4windowingui-Library-Configuration.html#LIBXFCE4WINDOWINGUI-MINOR-VERSION:CAPS" title="LIBXFCE4WINDOWINGUI_MINOR_VERSION"><span class="type">LIBXFCE4WINDOWINGUI_MINOR_VERSION</span></a> and
157 <a class="link" href="libxfce4windowingui-Library-Configuration.html#LIBXFCE4WINDOWINGUI-MICRO-VERSION:CAPS" title="LIBXFCE4WINDOWINGUI_MICRO_VERSION"><span class="type">LIBXFCE4WINDOWINGUI_MICRO_VERSION</span></a> as the three arguments to this function; that produces
158 a check that the library in use is compatible with the version of
159 libxfce4windowingui the extension was compiled against.</p>
160 <div class="informalexample">
161 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
162 <tbody>
163 <tr>
164 <td class="listing_lines" align="right"><pre>1
165 2
166 3
167 4
168 5
169 6
170 7</pre></td>
171 <td class="listing_code"><pre class="programlisting"><span class="k">const</span><span class="w"> </span><span class="n">gchar</span><span class="w"> </span><span class="o">*</span><span class="n">mismatch</span><span class="p">;</span>
172 <span class="n">mismatch</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">libxfce4windowingui_check_version</span><span class="p">(</span><span class="n">LIBXFCE4WINDOWINGUI_MAJOR_VERSION</span><span class="p">,</span>
173 <span class="w"> </span><span class="n">LIBXFCE4WINDOWINGUI_MINOR_VERSION</span><span class="p">,</span>
174 <span class="w"> </span><span class="n">LIBXFCE4WINDOWINGUI_MICRO_VERSION</span><span class="p">);</span>
175 <span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">G_UNLIKELY</span><span class="p">(</span><span class="n">mismatch</span><span class="w"> </span><span class="o">!=</span><span class="w"> </span><span class="nb">NULL</span><span class="p">))</span><span class="w"> </span><span class="p">{</span>
176 <span class="w"> </span><span class="n">g_error</span><span class="p">(</span><span class="s">&quot;Version mismatch: %s&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">mismatch</span><span class="p">);</span>
177 <span class="p">}</span></pre></td>
178 </tr>
179 </tbody>
180 </table>
181 </div>
182
183 <p></p>
184 <div class="refsect3">
185 <a name="libxfce4windowingui-check-version.parameters"></a><h4>Parameters</h4>
186 <div class="informaltable"><table class="informaltable" width="100%" border="0">
187 <colgroup>
188 <col width="150px" class="parameters_name">
189 <col class="parameters_description">
190 <col width="200px" class="parameters_annotations">
191 </colgroup>
192 <tbody>
193 <tr>
194 <td class="parameter_name"><p>required_major</p></td>
195 <td class="parameter_description"><p>the required major version.</p></td>
196 <td class="parameter_annotations"> </td>
197 </tr>
198 <tr>
199 <td class="parameter_name"><p>required_minor</p></td>
200 <td class="parameter_description"><p>the required minor version.</p></td>
201 <td class="parameter_annotations"> </td>
202 </tr>
203 <tr>
204 <td class="parameter_name"><p>required_micro</p></td>
205 <td class="parameter_description"><p>the required micro version.</p></td>
206 <td class="parameter_annotations"> </td>
207 </tr>
208 </tbody>
209 </table></div>
210 </div>
211 <div class="refsect3">
212 <a name="libxfce4windowingui-check-version.returns"></a><h4>Returns</h4>
213 <p><code class="literal">NULL</code> if the library is compatible
214 with the given version, or a string describing the version mismatch. The
215 returned string is owned by the library and must not be freed or modified by
216 the caller. </p>
217 <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
218 </div>
219 </div>
220 </div>
221 <div class="refsect1">
222 <a name="libxfce4windowingui-Library-Configuration.other_details"></a><h2>Types and Values</h2>
223 <div class="refsect2">
224 <a name="LIBXFCE4WINDOWINGUI-MAJOR-VERSION:CAPS"></a><h3>LIBXFCE4WINDOWINGUI_MAJOR_VERSION</h3>
225 <pre class="programlisting">#define LIBXFCE4WINDOWINGUI_MAJOR_VERSION (4)
226 </pre>
227 <p>A macro that evaluates to the major version of libxfce4windowingui, in a format
228 that can be used by the C pre-processor.</p>
229 </div>
230 <hr>
231 <div class="refsect2">
232 <a name="LIBXFCE4WINDOWINGUI-MINOR-VERSION:CAPS"></a><h3>LIBXFCE4WINDOWINGUI_MINOR_VERSION</h3>
233 <pre class="programlisting">#define LIBXFCE4WINDOWINGUI_MINOR_VERSION (20)
234 </pre>
235 <p>A macro that evaluates to the minor version of libxfce4windowingui, in a format
236 that can be used by the C pre-processor.</p>
237 </div>
238 <hr>
239 <div class="refsect2">
240 <a name="LIBXFCE4WINDOWINGUI-MICRO-VERSION:CAPS"></a><h3>LIBXFCE4WINDOWINGUI_MICRO_VERSION</h3>
241 <pre class="programlisting">#define LIBXFCE4WINDOWINGUI_MICRO_VERSION (6)
242 </pre>
243 <p>A macro that evaluates to the micro version of libxfce4windowingui, in a format
244 that can be used by the C pre-processor.</p>
245 </div>
246 <hr>
247 <div class="refsect2">
248 <a name="libxfce4windowingui-major-version"></a><h3>libxfce4windowingui_major_version</h3>
249 <pre class="programlisting">extern const guint libxfce4windowingui_major_version;
250 </pre>
251 <p>A constat that evaluates to the major version of libxfce4windowingui.</p>
252 </div>
253 <hr>
254 <div class="refsect2">
255 <a name="libxfce4windowingui-micro-version"></a><h3>libxfce4windowingui_micro_version</h3>
256 <pre class="programlisting">extern const guint libxfce4windowingui_micro_version;
257 </pre>
258 <p>A constat that evaluates to the micro version of libxfce4windowingui.</p>
259 </div>
260 <hr>
261 <div class="refsect2">
262 <a name="libxfce4windowingui-minor-version"></a><h3>libxfce4windowingui_minor_version</h3>
263 <pre class="programlisting">extern const guint libxfce4windowingui_minor_version;
264 </pre>
265 <p>A constat that evaluates to the minor version of libxfce4windowingui.</p>
266 </div>
267 </div>
268 </div>
269 <div class="footer">
270 <hr>Generated by GTK-Doc V1.34.0</div>
271 </body>
272 </html>