16
16
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
19
<refsynopsisdiv role="synopsis">
19
<refsynopsisdiv id="gupnp-xdgmime.synopsis" role="synopsis">
20
20
<title role="synopsis.title">Synopsis</title>
26
#define <link linkend="XDG-ENTRY:CAPS">XDG_ENTRY</link> (func)
27
#define <link linkend="XDG-RESERVED-ENTRY:CAPS">XDG_RESERVED_ENTRY</link> (func)
28
<link linkend="void">void</link> (<link linkend="XdgMimeCallback">*XdgMimeCallback</link>) (<link linkend="void">void</link> *user_data);
29
<link linkend="void">void</link> (<link linkend="XdgMimeDestroy">*XdgMimeDestroy</link>) (<link linkend="void">void</link> *user_data);
30
const <link linkend="char">char</link>* <link linkend="xdg-mime-get-mime-type-for-data">xdg_mime_get_mime_type_for_data</link> (const <link linkend="void">void</link> *data,
31
<link linkend="size-t">size_t</link> len);
32
const <link linkend="char">char</link>* <link linkend="xdg-mime-get-mime-type-for-file">xdg_mime_get_mime_type_for_file</link> (const <link linkend="char">char</link> *file_name,
33
<link linkend="struct-stat">struct stat</link> *statbuf);
34
const <link linkend="char">char</link>* <link linkend="xdg-mime-get-mime-type-from-file-name">xdg_mime_get_mime_type_from_file_name</link>
35
(const <link linkend="char">char</link> *file_name);
36
<link linkend="int">int</link> <link linkend="xdg-mime-is-valid-mime-type">xdg_mime_is_valid_mime_type</link> (const <link linkend="char">char</link> *mime_type);
37
<link linkend="int">int</link> <link linkend="xdg-mime-mime-type-equal">xdg_mime_mime_type_equal</link> (const <link linkend="char">char</link> *mime_a,
38
const <link linkend="char">char</link> *mime_b);
39
<link linkend="int">int</link> <link linkend="xdg-mime-media-type-equal">xdg_mime_media_type_equal</link> (const <link linkend="char">char</link> *mime_a,
40
const <link linkend="char">char</link> *mime_b);
41
<link linkend="int">int</link> <link linkend="xdg-mime-mime-type-subclass">xdg_mime_mime_type_subclass</link> (const <link linkend="char">char</link> *mime_a,
42
const <link linkend="char">char</link> *mime_b);
43
const <link linkend="char">char</link>** <link linkend="xdg-mime-get-mime-parents">xdg_mime_get_mime_parents</link> (const <link linkend="char">char</link> *mime);
44
<link linkend="char">char</link>** <link linkend="xdg-mime-list-mime-parents">xdg_mime_list_mime_parents</link> (const <link linkend="char">char</link> *mime);
45
const <link linkend="char">char</link>* <link linkend="xdg-mime-unalias-mime-type">xdg_mime_unalias_mime_type</link> (const <link linkend="char">char</link> *mime);
46
<link linkend="int">int</link> <link linkend="xdg-mime-get-max-buffer-extents">xdg_mime_get_max_buffer_extents</link> (void);
47
<link linkend="void">void</link> <link linkend="xdg-mime-shutdown">xdg_mime_shutdown</link> (void);
48
<link linkend="void">void</link> <link linkend="xdg-mime-dump">xdg_mime_dump</link> (void);
49
<link linkend="int">int</link> <link linkend="xdg-mime-register-reload-callback">xdg_mime_register_reload_callback</link> (<link linkend="XdgMimeCallback">XdgMimeCallback</link> callback,
50
<link linkend="void">void</link> *data,
51
<link linkend="XdgMimeDestroy">XdgMimeDestroy</link> destroy);
52
<link linkend="void">void</link> <link linkend="xdg-mime-remove-callback">xdg_mime_remove_callback</link> (<link linkend="int">int</link> callback_id);
53
#define <link linkend="xdg-mime-type-unknown">xdg_mime_type_unknown</link>
54
#define <link linkend="XDG-MIME-TYPE-UNKNOWN:CAPS">XDG_MIME_TYPE_UNKNOWN</link>
66
<refsect1 role="desc">
34
<refsect1 id="gupnp-xdgmime.description" role="desc">
67
35
<title role="desc.title">Description</title>
73
<refsect1 role="details">
41
<refsect1 id="gupnp-xdgmime.details" role="details">
74
42
<title role="details.title">Details</title>
76
<title><anchor id="XDG-ENTRY:CAPS" role="macro"/>XDG_ENTRY()</title>
77
<indexterm><primary>XDG_ENTRY</primary></indexterm><programlisting>#define XDG_ENTRY(func) _XDG_ENTRY2(XDG_PREFIX,func)
81
</para><variablelist role="params">
82
<varlistentry><term><parameter>func</parameter> :</term>
86
</simpara></listitem></varlistentry>
87
</variablelist></refsect2>
89
<title><anchor id="XDG-RESERVED-ENTRY:CAPS" role="macro"/>XDG_RESERVED_ENTRY()</title>
90
<indexterm><primary>XDG_RESERVED_ENTRY</primary></indexterm><programlisting>#define XDG_RESERVED_ENTRY(func) _XDG_RESERVED_ENTRY2(XDG_PREFIX,func)
94
</para><variablelist role="params">
95
<varlistentry><term><parameter>func</parameter> :</term>
99
</simpara></listitem></varlistentry>
100
</variablelist></refsect2>
102
<title><anchor id="XdgMimeCallback" role="function"/>XdgMimeCallback ()</title>
103
<indexterm><primary>XdgMimeCallback</primary></indexterm><programlisting><link linkend="void">void</link> (*XdgMimeCallback) (<link linkend="void">void</link> *user_data);</programlisting>
106
</para><variablelist role="params">
107
<varlistentry><term><parameter>user_data</parameter> :</term>
111
</simpara></listitem></varlistentry>
112
</variablelist></refsect2>
114
<title><anchor id="XdgMimeDestroy" role="function"/>XdgMimeDestroy ()</title>
115
<indexterm><primary>XdgMimeDestroy</primary></indexterm><programlisting><link linkend="void">void</link> (*XdgMimeDestroy) (<link linkend="void">void</link> *user_data);</programlisting>
118
</para><variablelist role="params">
119
<varlistentry><term><parameter>user_data</parameter> :</term>
123
</simpara></listitem></varlistentry>
124
</variablelist></refsect2>
126
<title><anchor id="xdg-mime-get-mime-type-for-data" role="function"/>xdg_mime_get_mime_type_for_data ()</title>
127
<indexterm><primary>xdg_mime_get_mime_type_for_data</primary></indexterm><programlisting>const <link linkend="char">char</link>* xdg_mime_get_mime_type_for_data (const <link linkend="void">void</link> *data,
128
<link linkend="size-t">size_t</link> len);</programlisting>
131
</para><variablelist role="params">
132
<varlistentry><term><parameter>data</parameter> :</term>
134
</simpara></listitem></varlistentry>
135
<varlistentry><term><parameter>len</parameter> :</term>
137
</simpara></listitem></varlistentry>
138
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
141
</simpara></listitem></varlistentry>
142
</variablelist></refsect2>
144
<title><anchor id="xdg-mime-get-mime-type-for-file" role="function"/>xdg_mime_get_mime_type_for_file ()</title>
145
<indexterm><primary>xdg_mime_get_mime_type_for_file</primary></indexterm><programlisting>const <link linkend="char">char</link>* xdg_mime_get_mime_type_for_file (const <link linkend="char">char</link> *file_name,
146
<link linkend="struct-stat">struct stat</link> *statbuf);</programlisting>
149
</para><variablelist role="params">
150
<varlistentry><term><parameter>file_name</parameter> :</term>
152
</simpara></listitem></varlistentry>
153
<varlistentry><term><parameter>statbuf</parameter> :</term>
155
</simpara></listitem></varlistentry>
156
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
159
</simpara></listitem></varlistentry>
160
</variablelist></refsect2>
162
<title><anchor id="xdg-mime-get-mime-type-from-file-name" role="function"/>xdg_mime_get_mime_type_from_file_name ()</title>
163
<indexterm><primary>xdg_mime_get_mime_type_from_file_name</primary></indexterm><programlisting>const <link linkend="char">char</link>* xdg_mime_get_mime_type_from_file_name
164
(const <link linkend="char">char</link> *file_name);</programlisting>
167
</para><variablelist role="params">
168
<varlistentry><term><parameter>file_name</parameter> :</term>
170
</simpara></listitem></varlistentry>
171
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
174
</simpara></listitem></varlistentry>
175
</variablelist></refsect2>
177
<title><anchor id="xdg-mime-is-valid-mime-type" role="function"/>xdg_mime_is_valid_mime_type ()</title>
178
<indexterm><primary>xdg_mime_is_valid_mime_type</primary></indexterm><programlisting><link linkend="int">int</link> xdg_mime_is_valid_mime_type (const <link linkend="char">char</link> *mime_type);</programlisting>
181
</para><variablelist role="params">
182
<varlistentry><term><parameter>mime_type</parameter> :</term>
184
</simpara></listitem></varlistentry>
185
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
188
</simpara></listitem></varlistentry>
189
</variablelist></refsect2>
191
<title><anchor id="xdg-mime-mime-type-equal" role="function"/>xdg_mime_mime_type_equal ()</title>
192
<indexterm><primary>xdg_mime_mime_type_equal</primary></indexterm><programlisting><link linkend="int">int</link> xdg_mime_mime_type_equal (const <link linkend="char">char</link> *mime_a,
193
const <link linkend="char">char</link> *mime_b);</programlisting>
196
</para><variablelist role="params">
197
<varlistentry><term><parameter>mime_a</parameter> :</term>
199
</simpara></listitem></varlistentry>
200
<varlistentry><term><parameter>mime_b</parameter> :</term>
202
</simpara></listitem></varlistentry>
203
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
206
</simpara></listitem></varlistentry>
207
</variablelist></refsect2>
209
<title><anchor id="xdg-mime-media-type-equal" role="function"/>xdg_mime_media_type_equal ()</title>
210
<indexterm><primary>xdg_mime_media_type_equal</primary></indexterm><programlisting><link linkend="int">int</link> xdg_mime_media_type_equal (const <link linkend="char">char</link> *mime_a,
211
const <link linkend="char">char</link> *mime_b);</programlisting>
214
</para><variablelist role="params">
215
<varlistentry><term><parameter>mime_a</parameter> :</term>
217
</simpara></listitem></varlistentry>
218
<varlistentry><term><parameter>mime_b</parameter> :</term>
220
</simpara></listitem></varlistentry>
221
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
224
</simpara></listitem></varlistentry>
225
</variablelist></refsect2>
227
<title><anchor id="xdg-mime-mime-type-subclass" role="function"/>xdg_mime_mime_type_subclass ()</title>
228
<indexterm><primary>xdg_mime_mime_type_subclass</primary></indexterm><programlisting><link linkend="int">int</link> xdg_mime_mime_type_subclass (const <link linkend="char">char</link> *mime_a,
229
const <link linkend="char">char</link> *mime_b);</programlisting>
232
</para><variablelist role="params">
233
<varlistentry><term><parameter>mime_a</parameter> :</term>
235
</simpara></listitem></varlistentry>
236
<varlistentry><term><parameter>mime_b</parameter> :</term>
238
</simpara></listitem></varlistentry>
239
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
242
</simpara></listitem></varlistentry>
243
</variablelist></refsect2>
245
<title><anchor id="xdg-mime-get-mime-parents" role="function"/>xdg_mime_get_mime_parents ()</title>
246
<indexterm><primary>xdg_mime_get_mime_parents</primary></indexterm><programlisting>const <link linkend="char">char</link>** xdg_mime_get_mime_parents (const <link linkend="char">char</link> *mime);</programlisting>
249
</para><variablelist role="params">
250
<varlistentry><term><parameter>mime</parameter> :</term>
252
</simpara></listitem></varlistentry>
253
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
256
</simpara></listitem></varlistentry>
257
</variablelist></refsect2>
259
<title><anchor id="xdg-mime-list-mime-parents" role="function"/>xdg_mime_list_mime_parents ()</title>
260
<indexterm><primary>xdg_mime_list_mime_parents</primary></indexterm><programlisting><link linkend="char">char</link>** xdg_mime_list_mime_parents (const <link linkend="char">char</link> *mime);</programlisting>
263
</para><variablelist role="params">
264
<varlistentry><term><parameter>mime</parameter> :</term>
266
</simpara></listitem></varlistentry>
267
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
270
</simpara></listitem></varlistentry>
271
</variablelist></refsect2>
273
<title><anchor id="xdg-mime-unalias-mime-type" role="function"/>xdg_mime_unalias_mime_type ()</title>
274
<indexterm><primary>xdg_mime_unalias_mime_type</primary></indexterm><programlisting>const <link linkend="char">char</link>* xdg_mime_unalias_mime_type (const <link linkend="char">char</link> *mime);</programlisting>
277
</para><variablelist role="params">
278
<varlistentry><term><parameter>mime</parameter> :</term>
280
</simpara></listitem></varlistentry>
281
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
284
</simpara></listitem></varlistentry>
285
</variablelist></refsect2>
287
<title><anchor id="xdg-mime-get-max-buffer-extents" role="function"/>xdg_mime_get_max_buffer_extents ()</title>
288
<indexterm><primary>xdg_mime_get_max_buffer_extents</primary></indexterm><programlisting><link linkend="int">int</link> xdg_mime_get_max_buffer_extents (void);</programlisting>
291
</para><variablelist role="params">
292
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
295
</simpara></listitem></varlistentry>
296
</variablelist></refsect2>
298
<title><anchor id="xdg-mime-shutdown" role="function"/>xdg_mime_shutdown ()</title>
299
<indexterm><primary>xdg_mime_shutdown</primary></indexterm><programlisting><link linkend="void">void</link> xdg_mime_shutdown (void);</programlisting>
304
<title><anchor id="xdg-mime-dump" role="function"/>xdg_mime_dump ()</title>
305
<indexterm><primary>xdg_mime_dump</primary></indexterm><programlisting><link linkend="void">void</link> xdg_mime_dump (void);</programlisting>
310
<title><anchor id="xdg-mime-register-reload-callback" role="function"/>xdg_mime_register_reload_callback ()</title>
311
<indexterm><primary>xdg_mime_register_reload_callback</primary></indexterm><programlisting><link linkend="int">int</link> xdg_mime_register_reload_callback (<link linkend="XdgMimeCallback">XdgMimeCallback</link> callback,
312
<link linkend="void">void</link> *data,
313
<link linkend="XdgMimeDestroy">XdgMimeDestroy</link> destroy);</programlisting>
316
</para><variablelist role="params">
317
<varlistentry><term><parameter>callback</parameter> :</term>
319
</simpara></listitem></varlistentry>
320
<varlistentry><term><parameter>data</parameter> :</term>
322
</simpara></listitem></varlistentry>
323
<varlistentry><term><parameter>destroy</parameter> :</term>
325
</simpara></listitem></varlistentry>
326
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
329
</simpara></listitem></varlistentry>
330
</variablelist></refsect2>
332
<title><anchor id="xdg-mime-remove-callback" role="function"/>xdg_mime_remove_callback ()</title>
333
<indexterm><primary>xdg_mime_remove_callback</primary></indexterm><programlisting><link linkend="void">void</link> xdg_mime_remove_callback (<link linkend="int">int</link> callback_id);</programlisting>
336
</para><variablelist role="params">
337
<varlistentry><term><parameter>callback_id</parameter> :</term>
341
</simpara></listitem></varlistentry>
342
</variablelist></refsect2>
344
<title><anchor id="xdg-mime-type-unknown" role="macro"/>xdg_mime_type_unknown</title>
345
<indexterm><primary>xdg_mime_type_unknown</primary></indexterm><programlisting>#define xdg_mime_type_unknown XDG_ENTRY(mime_type_unknown)
351
<title><anchor id="XDG-MIME-TYPE-UNKNOWN:CAPS" role="macro"/>XDG_MIME_TYPE_UNKNOWN</title>
352
<indexterm><primary>XDG_MIME_TYPE_UNKNOWN</primary></indexterm><programlisting>#define XDG_MIME_TYPE_UNKNOWN xdg_mime_type_unknown