0ff5df9d4b75c888476795060c77688ad5567fb8
[platform/upstream/fontconfig.git] / doc / fcstrset.sgml
1 <!--
2    fontconfig/doc/func.sgml
3   
4    Copyright © 2003 Keith Packard
5   
6    Permission to use, copy, modify, distribute, and sell this software and its
7    documentation for any purpose is hereby granted without fee, provided that
8    the above copyright notice appear in all copies and that both that
9    copyright notice and this permission notice appear in supporting
10    documentation, and that the name of the author(s) not be used in
11    advertising or publicity pertaining to distribution of the software without
12    specific, written prior permission.  The authors make no
13    representations about the suitability of this software for any purpose.  It
14    is provided "as is" without express or implied warranty.
15   
16    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
17    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
18    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
19    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
20    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
21    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
22    PERFORMANCE OF THIS SOFTWARE.
23  -->
24     <refentry id="FcStrSetCreate">
25         <refmeta>
26             <refentrytitle>FcStrSetCreate</refentrytitle>
27             <manvolnum>3</manvolnum>
28         </refmeta>
29         <refnamediv>
30             <refname>FcStrSetCreate</refname>
31             <refpurpose>create a string set</refpurpose>
32         </refnamediv>
33         <refsynopsisdiv>
34         <funcsynopsis>
35         <funcsynopsisinfo>
36 #include &lt;fontconfig/fontconfig.h&gt;
37         </funcsynopsisinfo>
38         <funcprototype>
39             <funcdef>FcStrSet * <function>FcStrSetCreate</function></funcdef>
40                 <paramdef>void<parameter></parameter></paramdef>
41         </funcprototype>
42         </funcsynopsis>
43         </refsynopsisdiv>
44         <refsect1><title>Description</title>
45             <para>
46 Create an empty set.
47             </para>
48         </refsect1>
49         <refsect1><title>Version</title>
50             <para>
51 Fontconfig version &version;
52             </para>
53         </refsect1>
54     </refentry>
55 <!--
56    fontconfig/doc/func.sgml
57   
58    Copyright © 2003 Keith Packard
59   
60    Permission to use, copy, modify, distribute, and sell this software and its
61    documentation for any purpose is hereby granted without fee, provided that
62    the above copyright notice appear in all copies and that both that
63    copyright notice and this permission notice appear in supporting
64    documentation, and that the name of the author(s) not be used in
65    advertising or publicity pertaining to distribution of the software without
66    specific, written prior permission.  The authors make no
67    representations about the suitability of this software for any purpose.  It
68    is provided "as is" without express or implied warranty.
69   
70    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
71    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
72    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
73    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
74    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
75    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
76    PERFORMANCE OF THIS SOFTWARE.
77  -->
78     <refentry id="FcStrSetMember">
79         <refmeta>
80             <refentrytitle>FcStrSetMember</refentrytitle>
81             <manvolnum>3</manvolnum>
82         </refmeta>
83         <refnamediv>
84             <refname>FcStrSetMember</refname>
85             <refpurpose>check set for membership</refpurpose>
86         </refnamediv>
87         <refsynopsisdiv>
88         <funcsynopsis>
89         <funcsynopsisinfo>
90 #include &lt;fontconfig/fontconfig.h&gt;
91         </funcsynopsisinfo>
92         <funcprototype>
93             <funcdef>FcBool <function>FcStrSetMember</function></funcdef>
94                 <paramdef>FcStrSet *<parameter>set</parameter></paramdef>
95                 <paramdef>const FcChar8 *<parameter>s</parameter></paramdef>
96         </funcprototype>
97         </funcsynopsis>
98         </refsynopsisdiv>
99         <refsect1><title>Description</title>
100             <para>
101 Returns whether <parameter>s</parameter> is a member of
102 <parameter>set</parameter>.
103             </para>
104         </refsect1>
105         <refsect1><title>Version</title>
106             <para>
107 Fontconfig version &version;
108             </para>
109         </refsect1>
110     </refentry>
111 <!--
112    fontconfig/doc/func.sgml
113   
114    Copyright © 2003 Keith Packard
115   
116    Permission to use, copy, modify, distribute, and sell this software and its
117    documentation for any purpose is hereby granted without fee, provided that
118    the above copyright notice appear in all copies and that both that
119    copyright notice and this permission notice appear in supporting
120    documentation, and that the name of the author(s) not be used in
121    advertising or publicity pertaining to distribution of the software without
122    specific, written prior permission.  The authors make no
123    representations about the suitability of this software for any purpose.  It
124    is provided "as is" without express or implied warranty.
125   
126    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
127    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
128    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
129    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
130    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
131    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
132    PERFORMANCE OF THIS SOFTWARE.
133  -->
134     <refentry id="FcStrSetEqual">
135         <refmeta>
136             <refentrytitle>FcStrSetEqual</refentrytitle>
137             <manvolnum>3</manvolnum>
138         </refmeta>
139         <refnamediv>
140             <refname>FcStrSetEqual</refname>
141             <refpurpose>check sets for equality</refpurpose>
142         </refnamediv>
143         <refsynopsisdiv>
144         <funcsynopsis>
145         <funcsynopsisinfo>
146 #include &lt;fontconfig/fontconfig.h&gt;
147         </funcsynopsisinfo>
148         <funcprototype>
149             <funcdef>FcBool <function>FcStrSetEqual</function></funcdef>
150                 <paramdef>FcStrSet *<parameter>set_a</parameter></paramdef>
151                 <paramdef>FcStrSet *<parameter>set_b</parameter></paramdef>
152         </funcprototype>
153         </funcsynopsis>
154         </refsynopsisdiv>
155         <refsect1><title>Description</title>
156             <para>
157 Returns whether <parameter>set_a</parameter> contains precisely the same
158 strings as <parameter>set_b</parameter>. Ordering of strings within the two
159 sets is not considered.
160             </para>
161         </refsect1>
162         <refsect1><title>Version</title>
163             <para>
164 Fontconfig version &version;
165             </para>
166         </refsect1>
167     </refentry>
168 <!--
169    fontconfig/doc/func.sgml
170   
171    Copyright © 2003 Keith Packard
172   
173    Permission to use, copy, modify, distribute, and sell this software and its
174    documentation for any purpose is hereby granted without fee, provided that
175    the above copyright notice appear in all copies and that both that
176    copyright notice and this permission notice appear in supporting
177    documentation, and that the name of the author(s) not be used in
178    advertising or publicity pertaining to distribution of the software without
179    specific, written prior permission.  The authors make no
180    representations about the suitability of this software for any purpose.  It
181    is provided "as is" without express or implied warranty.
182   
183    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
184    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
185    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
186    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
187    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
188    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
189    PERFORMANCE OF THIS SOFTWARE.
190  -->
191     <refentry id="FcStrSetAdd">
192         <refmeta>
193             <refentrytitle>FcStrSetAdd</refentrytitle>
194             <manvolnum>3</manvolnum>
195         </refmeta>
196         <refnamediv>
197             <refname>FcStrSetAdd</refname>
198             <refpurpose>add to a string set</refpurpose>
199         </refnamediv>
200         <refsynopsisdiv>
201         <funcsynopsis>
202         <funcsynopsisinfo>
203 #include &lt;fontconfig/fontconfig.h&gt;
204         </funcsynopsisinfo>
205         <funcprototype>
206             <funcdef>FcBool <function>FcStrSetAdd</function></funcdef>
207                 <paramdef>FcStrSet *<parameter>set</parameter></paramdef>
208                 <paramdef>const FcChar8 *<parameter>s</parameter></paramdef>
209         </funcprototype>
210         </funcsynopsis>
211         </refsynopsisdiv>
212         <refsect1><title>Description</title>
213             <para>
214 Adds a copy of <parameter>s</parameter> to <parameter>set</parameter>.
215             </para>
216         </refsect1>
217         <refsect1><title>Version</title>
218             <para>
219 Fontconfig version &version;
220             </para>
221         </refsect1>
222     </refentry>
223 <!--
224    fontconfig/doc/func.sgml
225   
226    Copyright © 2003 Keith Packard
227   
228    Permission to use, copy, modify, distribute, and sell this software and its
229    documentation for any purpose is hereby granted without fee, provided that
230    the above copyright notice appear in all copies and that both that
231    copyright notice and this permission notice appear in supporting
232    documentation, and that the name of the author(s) not be used in
233    advertising or publicity pertaining to distribution of the software without
234    specific, written prior permission.  The authors make no
235    representations about the suitability of this software for any purpose.  It
236    is provided "as is" without express or implied warranty.
237   
238    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
239    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
240    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
241    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
242    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
243    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
244    PERFORMANCE OF THIS SOFTWARE.
245  -->
246     <refentry id="FcStrSetAddFilename">
247         <refmeta>
248             <refentrytitle>FcStrSetAddFilename</refentrytitle>
249             <manvolnum>3</manvolnum>
250         </refmeta>
251         <refnamediv>
252             <refname>FcStrSetAddFilename</refname>
253             <refpurpose>add a filename to a string set</refpurpose>
254         </refnamediv>
255         <refsynopsisdiv>
256         <funcsynopsis>
257         <funcsynopsisinfo>
258 #include &lt;fontconfig/fontconfig.h&gt;
259         </funcsynopsisinfo>
260         <funcprototype>
261             <funcdef>FcBool <function>FcStrSetAddFilename</function></funcdef>
262                 <paramdef>FcStrSet *<parameter>set</parameter></paramdef>
263                 <paramdef>const FcChar8 *<parameter>s</parameter></paramdef>
264         </funcprototype>
265         </funcsynopsis>
266         </refsynopsisdiv>
267         <refsect1><title>Description</title>
268             <para>
269 Adds a copy <parameter>s</parameter> to <parameter>set</parameter>, The copy
270 is created with FcStrCopyFilename so that leading '~' values are replaced
271 with the value of the HOME environment variable.
272             </para>
273         </refsect1>
274         <refsect1><title>Version</title>
275             <para>
276 Fontconfig version &version;
277             </para>
278         </refsect1>
279     </refentry>
280 <!--
281    fontconfig/doc/func.sgml
282   
283    Copyright © 2003 Keith Packard
284   
285    Permission to use, copy, modify, distribute, and sell this software and its
286    documentation for any purpose is hereby granted without fee, provided that
287    the above copyright notice appear in all copies and that both that
288    copyright notice and this permission notice appear in supporting
289    documentation, and that the name of the author(s) not be used in
290    advertising or publicity pertaining to distribution of the software without
291    specific, written prior permission.  The authors make no
292    representations about the suitability of this software for any purpose.  It
293    is provided "as is" without express or implied warranty.
294   
295    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
296    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
297    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
298    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
299    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
300    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
301    PERFORMANCE OF THIS SOFTWARE.
302  -->
303     <refentry id="FcStrSetDel">
304         <refmeta>
305             <refentrytitle>FcStrSetDel</refentrytitle>
306             <manvolnum>3</manvolnum>
307         </refmeta>
308         <refnamediv>
309             <refname>FcStrSetDel</refname>
310             <refpurpose>delete from a string set</refpurpose>
311         </refnamediv>
312         <refsynopsisdiv>
313         <funcsynopsis>
314         <funcsynopsisinfo>
315 #include &lt;fontconfig/fontconfig.h&gt;
316         </funcsynopsisinfo>
317         <funcprototype>
318             <funcdef>FcBool <function>FcStrSetDel</function></funcdef>
319                 <paramdef>FcStrSet *<parameter>set</parameter></paramdef>
320                 <paramdef>const FcChar8 *<parameter>s</parameter></paramdef>
321         </funcprototype>
322         </funcsynopsis>
323         </refsynopsisdiv>
324         <refsect1><title>Description</title>
325             <para>
326 Removes <parameter>s</parameter> from <parameter>set</parameter>, returning
327 FcTrue if <parameter>s</parameter> was a member else FcFalse.
328             </para>
329         </refsect1>
330         <refsect1><title>Version</title>
331             <para>
332 Fontconfig version &version;
333             </para>
334         </refsect1>
335     </refentry>
336 <!--
337    fontconfig/doc/func.sgml
338   
339    Copyright © 2003 Keith Packard
340   
341    Permission to use, copy, modify, distribute, and sell this software and its
342    documentation for any purpose is hereby granted without fee, provided that
343    the above copyright notice appear in all copies and that both that
344    copyright notice and this permission notice appear in supporting
345    documentation, and that the name of the author(s) not be used in
346    advertising or publicity pertaining to distribution of the software without
347    specific, written prior permission.  The authors make no
348    representations about the suitability of this software for any purpose.  It
349    is provided "as is" without express or implied warranty.
350   
351    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
352    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
353    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
354    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
355    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
356    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
357    PERFORMANCE OF THIS SOFTWARE.
358  -->
359     <refentry id="FcStrSetDestroy">
360         <refmeta>
361             <refentrytitle>FcStrSetDestroy</refentrytitle>
362             <manvolnum>3</manvolnum>
363         </refmeta>
364         <refnamediv>
365             <refname>FcStrSetDestroy</refname>
366             <refpurpose>destroy a string set</refpurpose>
367         </refnamediv>
368         <refsynopsisdiv>
369         <funcsynopsis>
370         <funcsynopsisinfo>
371 #include &lt;fontconfig/fontconfig.h&gt;
372         </funcsynopsisinfo>
373         <funcprototype>
374             <funcdef>void <function>FcStrSetDestroy</function></funcdef>
375                 <paramdef>FcStrSet *<parameter>set</parameter></paramdef>
376         </funcprototype>
377         </funcsynopsis>
378         </refsynopsisdiv>
379         <refsect1><title>Description</title>
380             <para>
381 Destroys <parameter>set</parameter>.
382             </para>
383         </refsect1>
384         <refsect1><title>Version</title>
385             <para>
386 Fontconfig version &version;
387             </para>
388         </refsect1>
389     </refentry>
390 <!--
391    fontconfig/doc/func.sgml
392   
393    Copyright © 2003 Keith Packard
394   
395    Permission to use, copy, modify, distribute, and sell this software and its
396    documentation for any purpose is hereby granted without fee, provided that
397    the above copyright notice appear in all copies and that both that
398    copyright notice and this permission notice appear in supporting
399    documentation, and that the name of the author(s) not be used in
400    advertising or publicity pertaining to distribution of the software without
401    specific, written prior permission.  The authors make no
402    representations about the suitability of this software for any purpose.  It
403    is provided "as is" without express or implied warranty.
404   
405    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
406    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
407    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
408    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
409    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
410    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
411    PERFORMANCE OF THIS SOFTWARE.
412  -->
413     <refentry id="FcStrListCreate">
414         <refmeta>
415             <refentrytitle>FcStrListCreate</refentrytitle>
416             <manvolnum>3</manvolnum>
417         </refmeta>
418         <refnamediv>
419             <refname>FcStrListCreate</refname>
420             <refpurpose>create a string iterator</refpurpose>
421         </refnamediv>
422         <refsynopsisdiv>
423         <funcsynopsis>
424         <funcsynopsisinfo>
425 #include &lt;fontconfig/fontconfig.h&gt;
426         </funcsynopsisinfo>
427         <funcprototype>
428             <funcdef>FcStrList * <function>FcStrListCreate</function></funcdef>
429                 <paramdef>FcStrSet *<parameter>set</parameter></paramdef>
430         </funcprototype>
431         </funcsynopsis>
432         </refsynopsisdiv>
433         <refsect1><title>Description</title>
434             <para>
435 Creates an iterator to list the strings in <parameter>set</parameter>.
436             </para>
437         </refsect1>
438         <refsect1><title>Version</title>
439             <para>
440 Fontconfig version &version;
441             </para>
442         </refsect1>
443     </refentry>
444 <!--
445    fontconfig/doc/func.sgml
446   
447    Copyright © 2003 Keith Packard
448   
449    Permission to use, copy, modify, distribute, and sell this software and its
450    documentation for any purpose is hereby granted without fee, provided that
451    the above copyright notice appear in all copies and that both that
452    copyright notice and this permission notice appear in supporting
453    documentation, and that the name of the author(s) not be used in
454    advertising or publicity pertaining to distribution of the software without
455    specific, written prior permission.  The authors make no
456    representations about the suitability of this software for any purpose.  It
457    is provided "as is" without express or implied warranty.
458   
459    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
460    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
461    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
462    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
463    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
464    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
465    PERFORMANCE OF THIS SOFTWARE.
466  -->
467     <refentry id="FcStrListNext">
468         <refmeta>
469             <refentrytitle>FcStrListNext</refentrytitle>
470             <manvolnum>3</manvolnum>
471         </refmeta>
472         <refnamediv>
473             <refname>FcStrListNext</refname>
474             <refpurpose>get next string in iteration</refpurpose>
475         </refnamediv>
476         <refsynopsisdiv>
477         <funcsynopsis>
478         <funcsynopsisinfo>
479 #include &lt;fontconfig/fontconfig.h&gt;
480         </funcsynopsisinfo>
481         <funcprototype>
482             <funcdef>FcChar8 * <function>FcStrListNext</function></funcdef>
483                 <paramdef>FcStrList *<parameter>list</parameter></paramdef>
484         </funcprototype>
485         </funcsynopsis>
486         </refsynopsisdiv>
487         <refsect1><title>Description</title>
488             <para>
489 Returns the next string in <parameter>set</parameter>.
490             </para>
491         </refsect1>
492         <refsect1><title>Version</title>
493             <para>
494 Fontconfig version &version;
495             </para>
496         </refsect1>
497     </refentry>
498 <!--
499    fontconfig/doc/func.sgml
500   
501    Copyright © 2003 Keith Packard
502   
503    Permission to use, copy, modify, distribute, and sell this software and its
504    documentation for any purpose is hereby granted without fee, provided that
505    the above copyright notice appear in all copies and that both that
506    copyright notice and this permission notice appear in supporting
507    documentation, and that the name of the author(s) not be used in
508    advertising or publicity pertaining to distribution of the software without
509    specific, written prior permission.  The authors make no
510    representations about the suitability of this software for any purpose.  It
511    is provided "as is" without express or implied warranty.
512   
513    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
514    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
515    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
516    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
517    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
518    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
519    PERFORMANCE OF THIS SOFTWARE.
520  -->
521     <refentry id="FcStrListDone">
522         <refmeta>
523             <refentrytitle>FcStrListDone</refentrytitle>
524             <manvolnum>3</manvolnum>
525         </refmeta>
526         <refnamediv>
527             <refname>FcStrListDone</refname>
528             <refpurpose>destroy a string iterator</refpurpose>
529         </refnamediv>
530         <refsynopsisdiv>
531         <funcsynopsis>
532         <funcsynopsisinfo>
533 #include &lt;fontconfig/fontconfig.h&gt;
534         </funcsynopsisinfo>
535         <funcprototype>
536             <funcdef>void <function>FcStrListDone</function></funcdef>
537                 <paramdef>FcStrList *<parameter>list</parameter></paramdef>
538         </funcprototype>
539         </funcsynopsis>
540         </refsynopsisdiv>
541         <refsect1><title>Description</title>
542             <para>
543 Destroys the enumerator <parameter>list</parameter>.
544             </para>
545         </refsect1>
546         <refsect1><title>Version</title>
547             <para>
548 Fontconfig version &version;
549             </para>
550         </refsect1>
551     </refentry>