2 fontconfig/doc/func.sgml
4 Copyright © 2003 Keith Packard
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.
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.
24 <refentry id="FcCharSetCreate">
26 <refentrytitle>FcCharSetCreate</refentrytitle>
27 <manvolnum>3</manvolnum>
28 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
31 <refname>FcCharSetCreate</refname>
32 <refpurpose>Create an empty character set</refpurpose>
37 #include <fontconfig/fontconfig.h>
40 <funcdef>FcCharSet * <function>FcCharSetCreate</function></funcdef>
41 <paramdef>void<parameter></parameter></paramdef>
45 <refsect1><title>Description</title>
47 <function>FcCharSetCreate</function> allocates and initializes a new empty
53 fontconfig/doc/func.sgml
55 Copyright © 2003 Keith Packard
57 Permission to use, copy, modify, distribute, and sell this software and its
58 documentation for any purpose is hereby granted without fee, provided that
59 the above copyright notice appear in all copies and that both that
60 copyright notice and this permission notice appear in supporting
61 documentation, and that the name of the author(s) not be used in
62 advertising or publicity pertaining to distribution of the software without
63 specific, written prior permission. The authors make no
64 representations about the suitability of this software for any purpose. It
65 is provided "as is" without express or implied warranty.
67 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
68 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
69 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
70 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
71 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
72 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
73 PERFORMANCE OF THIS SOFTWARE.
75 <refentry id="FcCharSetDestroy">
77 <refentrytitle>FcCharSetDestroy</refentrytitle>
78 <manvolnum>3</manvolnum>
79 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
82 <refname>FcCharSetDestroy</refname>
83 <refpurpose>Destroy a character set</refpurpose>
88 #include <fontconfig/fontconfig.h>
91 <funcdef>void <function>FcCharSetDestroy</function></funcdef>
92 <paramdef>FcCharSet *<parameter>fcs</parameter></paramdef>
96 <refsect1><title>Description</title>
98 <function>FcCharSetDestroy</function> decrements the reference count
99 <parameter>fcs</parameter>. If the reference count becomes zero, all
100 memory referenced is freed.
105 fontconfig/doc/func.sgml
107 Copyright © 2003 Keith Packard
109 Permission to use, copy, modify, distribute, and sell this software and its
110 documentation for any purpose is hereby granted without fee, provided that
111 the above copyright notice appear in all copies and that both that
112 copyright notice and this permission notice appear in supporting
113 documentation, and that the name of the author(s) not be used in
114 advertising or publicity pertaining to distribution of the software without
115 specific, written prior permission. The authors make no
116 representations about the suitability of this software for any purpose. It
117 is provided "as is" without express or implied warranty.
119 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
120 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
121 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
122 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
123 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
124 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
125 PERFORMANCE OF THIS SOFTWARE.
127 <refentry id="FcCharSetAddChar">
129 <refentrytitle>FcCharSetAddChar</refentrytitle>
130 <manvolnum>3</manvolnum>
131 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
134 <refname>FcCharSetAddChar</refname>
135 <refpurpose>Add a character to a charset</refpurpose>
140 #include <fontconfig/fontconfig.h>
143 <funcdef>FcBool <function>FcCharSetAddChar</function></funcdef>
144 <paramdef>FcCharSet *<parameter>fcs</parameter></paramdef>
145 <paramdef>FcChar32 <parameter>ucs4</parameter></paramdef>
149 <refsect1><title>Description</title>
151 <function>FcCharSetAddChar</function> adds a single Unicode char to the set,
152 returning FcFalse on failure, either as a result of a constant set or from
153 running out of memory.
158 fontconfig/doc/func.sgml
160 Copyright © 2003 Keith Packard
162 Permission to use, copy, modify, distribute, and sell this software and its
163 documentation for any purpose is hereby granted without fee, provided that
164 the above copyright notice appear in all copies and that both that
165 copyright notice and this permission notice appear in supporting
166 documentation, and that the name of the author(s) not be used in
167 advertising or publicity pertaining to distribution of the software without
168 specific, written prior permission. The authors make no
169 representations about the suitability of this software for any purpose. It
170 is provided "as is" without express or implied warranty.
172 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
173 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
174 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
175 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
176 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
177 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
178 PERFORMANCE OF THIS SOFTWARE.
180 <refentry id="FcCharSetDelChar">
182 <refentrytitle>FcCharSetDelChar</refentrytitle>
183 <manvolnum>3</manvolnum>
184 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
187 <refname>FcCharSetDelChar</refname>
188 <refpurpose>Add a character to a charset</refpurpose>
193 #include <fontconfig/fontconfig.h>
196 <funcdef>FcBool <function>FcCharSetDelChar</function></funcdef>
197 <paramdef>FcCharSet *<parameter>fcs</parameter></paramdef>
198 <paramdef>FcChar32 <parameter>ucs4</parameter></paramdef>
202 <refsect1><title>Description</title>
204 <function>FcCharSetDelChar</function> deletes a single Unicode char from the set,
205 returning FcFalse on failure, either as a result of a constant set or from
206 running out of memory.
209 <refsect1><title>Since</title>
210 <para>version 2.9.0</para>
214 fontconfig/doc/func.sgml
216 Copyright © 2003 Keith Packard
218 Permission to use, copy, modify, distribute, and sell this software and its
219 documentation for any purpose is hereby granted without fee, provided that
220 the above copyright notice appear in all copies and that both that
221 copyright notice and this permission notice appear in supporting
222 documentation, and that the name of the author(s) not be used in
223 advertising or publicity pertaining to distribution of the software without
224 specific, written prior permission. The authors make no
225 representations about the suitability of this software for any purpose. It
226 is provided "as is" without express or implied warranty.
228 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
229 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
230 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
231 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
232 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
233 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
234 PERFORMANCE OF THIS SOFTWARE.
236 <refentry id="FcCharSetCopy">
238 <refentrytitle>FcCharSetCopy</refentrytitle>
239 <manvolnum>3</manvolnum>
240 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
243 <refname>FcCharSetCopy</refname>
244 <refpurpose>Copy a charset</refpurpose>
249 #include <fontconfig/fontconfig.h>
252 <funcdef>FcCharSet * <function>FcCharSetCopy</function></funcdef>
253 <paramdef>FcCharSet *<parameter>src</parameter></paramdef>
257 <refsect1><title>Description</title>
259 Makes a copy of <parameter>src</parameter>; note that this may not actually do anything more
260 than increment the reference count on <parameter>src</parameter>.
265 fontconfig/doc/func.sgml
267 Copyright © 2003 Keith Packard
269 Permission to use, copy, modify, distribute, and sell this software and its
270 documentation for any purpose is hereby granted without fee, provided that
271 the above copyright notice appear in all copies and that both that
272 copyright notice and this permission notice appear in supporting
273 documentation, and that the name of the author(s) not be used in
274 advertising or publicity pertaining to distribution of the software without
275 specific, written prior permission. The authors make no
276 representations about the suitability of this software for any purpose. It
277 is provided "as is" without express or implied warranty.
279 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
280 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
281 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
282 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
283 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
284 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
285 PERFORMANCE OF THIS SOFTWARE.
287 <refentry id="FcCharSetEqual">
289 <refentrytitle>FcCharSetEqual</refentrytitle>
290 <manvolnum>3</manvolnum>
291 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
294 <refname>FcCharSetEqual</refname>
295 <refpurpose>Compare two charsets</refpurpose>
300 #include <fontconfig/fontconfig.h>
303 <funcdef>FcBool <function>FcCharSetEqual</function></funcdef>
304 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
305 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
309 <refsect1><title>Description</title>
311 Returns whether <parameter>a</parameter> and <parameter>b</parameter>
312 contain the same set of Unicode chars.
317 fontconfig/doc/func.sgml
319 Copyright © 2003 Keith Packard
321 Permission to use, copy, modify, distribute, and sell this software and its
322 documentation for any purpose is hereby granted without fee, provided that
323 the above copyright notice appear in all copies and that both that
324 copyright notice and this permission notice appear in supporting
325 documentation, and that the name of the author(s) not be used in
326 advertising or publicity pertaining to distribution of the software without
327 specific, written prior permission. The authors make no
328 representations about the suitability of this software for any purpose. It
329 is provided "as is" without express or implied warranty.
331 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
332 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
333 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
334 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
335 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
336 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
337 PERFORMANCE OF THIS SOFTWARE.
339 <refentry id="FcCharSetIntersect">
341 <refentrytitle>FcCharSetIntersect</refentrytitle>
342 <manvolnum>3</manvolnum>
343 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
346 <refname>FcCharSetIntersect</refname>
347 <refpurpose>Intersect charsets</refpurpose>
352 #include <fontconfig/fontconfig.h>
355 <funcdef>FcCharSet * <function>FcCharSetIntersect</function></funcdef>
356 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
357 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
361 <refsect1><title>Description</title>
363 Returns a set including only those chars found in both
364 <parameter>a</parameter> and <parameter>b</parameter>.
369 fontconfig/doc/func.sgml
371 Copyright © 2003 Keith Packard
373 Permission to use, copy, modify, distribute, and sell this software and its
374 documentation for any purpose is hereby granted without fee, provided that
375 the above copyright notice appear in all copies and that both that
376 copyright notice and this permission notice appear in supporting
377 documentation, and that the name of the author(s) not be used in
378 advertising or publicity pertaining to distribution of the software without
379 specific, written prior permission. The authors make no
380 representations about the suitability of this software for any purpose. It
381 is provided "as is" without express or implied warranty.
383 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
384 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
385 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
386 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
387 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
388 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
389 PERFORMANCE OF THIS SOFTWARE.
391 <refentry id="FcCharSetUnion">
393 <refentrytitle>FcCharSetUnion</refentrytitle>
394 <manvolnum>3</manvolnum>
395 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
398 <refname>FcCharSetUnion</refname>
399 <refpurpose>Add charsets</refpurpose>
404 #include <fontconfig/fontconfig.h>
407 <funcdef>FcCharSet * <function>FcCharSetUnion</function></funcdef>
408 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
409 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
413 <refsect1><title>Description</title>
415 Returns a set including only those chars found in either <parameter>a</parameter> or <parameter>b</parameter>.
420 fontconfig/doc/func.sgml
422 Copyright © 2003 Keith Packard
424 Permission to use, copy, modify, distribute, and sell this software and its
425 documentation for any purpose is hereby granted without fee, provided that
426 the above copyright notice appear in all copies and that both that
427 copyright notice and this permission notice appear in supporting
428 documentation, and that the name of the author(s) not be used in
429 advertising or publicity pertaining to distribution of the software without
430 specific, written prior permission. The authors make no
431 representations about the suitability of this software for any purpose. It
432 is provided "as is" without express or implied warranty.
434 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
435 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
436 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
437 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
438 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
439 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
440 PERFORMANCE OF THIS SOFTWARE.
442 <refentry id="FcCharSetSubtract">
444 <refentrytitle>FcCharSetSubtract</refentrytitle>
445 <manvolnum>3</manvolnum>
446 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
449 <refname>FcCharSetSubtract</refname>
450 <refpurpose>Subtract charsets</refpurpose>
455 #include <fontconfig/fontconfig.h>
458 <funcdef>FcCharSet * <function>FcCharSetSubtract</function></funcdef>
459 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
460 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
464 <refsect1><title>Description</title>
466 Returns a set including only those chars found in <parameter>a</parameter> but not <parameter>b</parameter>.
471 fontconfig/doc/func.sgml
473 Copyright © 2003 Keith Packard
475 Permission to use, copy, modify, distribute, and sell this software and its
476 documentation for any purpose is hereby granted without fee, provided that
477 the above copyright notice appear in all copies and that both that
478 copyright notice and this permission notice appear in supporting
479 documentation, and that the name of the author(s) not be used in
480 advertising or publicity pertaining to distribution of the software without
481 specific, written prior permission. The authors make no
482 representations about the suitability of this software for any purpose. It
483 is provided "as is" without express or implied warranty.
485 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
486 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
487 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
488 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
489 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
490 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
491 PERFORMANCE OF THIS SOFTWARE.
493 <refentry id="FcCharSetMerge">
495 <refentrytitle>FcCharSetMerge</refentrytitle>
496 <manvolnum>3</manvolnum>
497 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
500 <refname>FcCharSetMerge</refname>
501 <refpurpose>Merge charsets</refpurpose>
506 #include <fontconfig/fontconfig.h>
509 <funcdef>FcBool <function>FcCharSetMerge</function></funcdef>
510 <paramdef>FcCharSet *<parameter>a</parameter></paramdef>
511 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
512 <paramdef>FcBool *<parameter>changed</parameter></paramdef>
516 <refsect1><title>Description</title>
518 Adds all chars in <parameter>b</parameter> to <parameter>a</parameter>.
519 In other words, this is an in-place version of FcCharSetUnion.
520 If <parameter>changed</parameter> is not NULL, then it returns whether any new
521 chars from <parameter>b</parameter> were added to <parameter>a</parameter>.
522 Returns FcFalse on failure, either when <parameter>a</parameter> is a constant
523 set or from running out of memory.
528 fontconfig/doc/func.sgml
530 Copyright © 2003 Keith Packard
532 Permission to use, copy, modify, distribute, and sell this software and its
533 documentation for any purpose is hereby granted without fee, provided that
534 the above copyright notice appear in all copies and that both that
535 copyright notice and this permission notice appear in supporting
536 documentation, and that the name of the author(s) not be used in
537 advertising or publicity pertaining to distribution of the software without
538 specific, written prior permission. The authors make no
539 representations about the suitability of this software for any purpose. It
540 is provided "as is" without express or implied warranty.
542 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
543 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
544 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
545 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
546 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
547 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
548 PERFORMANCE OF THIS SOFTWARE.
550 <refentry id="FcCharSetHasChar">
552 <refentrytitle>FcCharSetHasChar</refentrytitle>
553 <manvolnum>3</manvolnum>
554 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
557 <refname>FcCharSetHasChar</refname>
558 <refpurpose>Check a charset for a char</refpurpose>
563 #include <fontconfig/fontconfig.h>
566 <funcdef>FcBool <function>FcCharSetHasChar</function></funcdef>
567 <paramdef>const FcCharSet *<parameter>fcs</parameter></paramdef>
568 <paramdef>FcChar32 <parameter>ucs4</parameter></paramdef>
572 <refsect1><title>Description</title>
574 Returns whether <parameter>fcs</parameter> contains the char <parameter>ucs4</parameter>.
579 fontconfig/doc/func.sgml
581 Copyright © 2003 Keith Packard
583 Permission to use, copy, modify, distribute, and sell this software and its
584 documentation for any purpose is hereby granted without fee, provided that
585 the above copyright notice appear in all copies and that both that
586 copyright notice and this permission notice appear in supporting
587 documentation, and that the name of the author(s) not be used in
588 advertising or publicity pertaining to distribution of the software without
589 specific, written prior permission. The authors make no
590 representations about the suitability of this software for any purpose. It
591 is provided "as is" without express or implied warranty.
593 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
594 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
595 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
596 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
597 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
598 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
599 PERFORMANCE OF THIS SOFTWARE.
601 <refentry id="FcCharSetCount">
603 <refentrytitle>FcCharSetCount</refentrytitle>
604 <manvolnum>3</manvolnum>
605 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
608 <refname>FcCharSetCount</refname>
609 <refpurpose>Count entries in a charset</refpurpose>
614 #include <fontconfig/fontconfig.h>
617 <funcdef>FcChar32 <function>FcCharSetCount</function></funcdef>
618 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
622 <refsect1><title>Description</title>
624 Returns the total number of Unicode chars in <parameter>a</parameter>.
629 fontconfig/doc/func.sgml
631 Copyright © 2003 Keith Packard
633 Permission to use, copy, modify, distribute, and sell this software and its
634 documentation for any purpose is hereby granted without fee, provided that
635 the above copyright notice appear in all copies and that both that
636 copyright notice and this permission notice appear in supporting
637 documentation, and that the name of the author(s) not be used in
638 advertising or publicity pertaining to distribution of the software without
639 specific, written prior permission. The authors make no
640 representations about the suitability of this software for any purpose. It
641 is provided "as is" without express or implied warranty.
643 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
644 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
645 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
646 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
647 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
648 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
649 PERFORMANCE OF THIS SOFTWARE.
651 <refentry id="FcCharSetIntersectCount">
653 <refentrytitle>FcCharSetIntersectCount</refentrytitle>
654 <manvolnum>3</manvolnum>
655 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
658 <refname>FcCharSetIntersectCount</refname>
659 <refpurpose>Intersect and count charsets</refpurpose>
664 #include <fontconfig/fontconfig.h>
667 <funcdef>FcChar32 <function>FcCharSetIntersectCount</function></funcdef>
668 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
669 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
673 <refsect1><title>Description</title>
675 Returns the number of chars that are in both <parameter>a</parameter> and <parameter>b</parameter>.
680 fontconfig/doc/func.sgml
682 Copyright © 2003 Keith Packard
684 Permission to use, copy, modify, distribute, and sell this software and its
685 documentation for any purpose is hereby granted without fee, provided that
686 the above copyright notice appear in all copies and that both that
687 copyright notice and this permission notice appear in supporting
688 documentation, and that the name of the author(s) not be used in
689 advertising or publicity pertaining to distribution of the software without
690 specific, written prior permission. The authors make no
691 representations about the suitability of this software for any purpose. It
692 is provided "as is" without express or implied warranty.
694 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
695 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
696 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
697 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
698 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
699 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
700 PERFORMANCE OF THIS SOFTWARE.
702 <refentry id="FcCharSetSubtractCount">
704 <refentrytitle>FcCharSetSubtractCount</refentrytitle>
705 <manvolnum>3</manvolnum>
706 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
709 <refname>FcCharSetSubtractCount</refname>
710 <refpurpose>Subtract and count charsets</refpurpose>
715 #include <fontconfig/fontconfig.h>
718 <funcdef>FcChar32 <function>FcCharSetSubtractCount</function></funcdef>
719 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
720 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
724 <refsect1><title>Description</title>
726 Returns the number of chars that are in <parameter>a</parameter> but not in <parameter>b</parameter>.
731 fontconfig/doc/func.sgml
733 Copyright © 2003 Keith Packard
735 Permission to use, copy, modify, distribute, and sell this software and its
736 documentation for any purpose is hereby granted without fee, provided that
737 the above copyright notice appear in all copies and that both that
738 copyright notice and this permission notice appear in supporting
739 documentation, and that the name of the author(s) not be used in
740 advertising or publicity pertaining to distribution of the software without
741 specific, written prior permission. The authors make no
742 representations about the suitability of this software for any purpose. It
743 is provided "as is" without express or implied warranty.
745 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
746 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
747 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
748 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
749 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
750 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
751 PERFORMANCE OF THIS SOFTWARE.
753 <refentry id="FcCharSetIsSubset">
755 <refentrytitle>FcCharSetIsSubset</refentrytitle>
756 <manvolnum>3</manvolnum>
757 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
760 <refname>FcCharSetIsSubset</refname>
761 <refpurpose>Test for charset inclusion</refpurpose>
766 #include <fontconfig/fontconfig.h>
769 <funcdef>FcBool <function>FcCharSetIsSubset</function></funcdef>
770 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
771 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
775 <refsect1><title>Description</title>
777 Returns whether <parameter>a</parameter> is a subset of <parameter>b</parameter>.
782 fontconfig/doc/func.sgml
784 Copyright © 2003 Keith Packard
786 Permission to use, copy, modify, distribute, and sell this software and its
787 documentation for any purpose is hereby granted without fee, provided that
788 the above copyright notice appear in all copies and that both that
789 copyright notice and this permission notice appear in supporting
790 documentation, and that the name of the author(s) not be used in
791 advertising or publicity pertaining to distribution of the software without
792 specific, written prior permission. The authors make no
793 representations about the suitability of this software for any purpose. It
794 is provided "as is" without express or implied warranty.
796 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
797 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
798 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
799 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
800 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
801 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
802 PERFORMANCE OF THIS SOFTWARE.
804 <refentry id="FcCharSetFirstPage">
806 <refentrytitle>FcCharSetFirstPage</refentrytitle>
807 <manvolnum>3</manvolnum>
808 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
811 <refname>FcCharSetFirstPage</refname>
812 <refpurpose>Start enumerating charset contents</refpurpose>
817 #include <fontconfig/fontconfig.h>
820 <funcdef>FcChar32 <function>FcCharSetFirstPage</function></funcdef>
821 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
822 <paramdef>FcChar32[FC_CHARSET_MAP_SIZE] <parameter>map</parameter></paramdef>
823 <paramdef>FcChar32 *<parameter>next</parameter></paramdef>
827 <refsect1><title>Description</title>
829 Builds an array of bits in <parameter>map</parameter> marking the
830 first page of Unicode coverage of <parameter>a</parameter>.
831 <parameter>*next</parameter> is set to contains the base code point
832 for the next page in <parameter>a</parameter>. Returns the base code
833 point for the page, or <constant>FC_CHARSET_DONE</constant> if
834 <parameter>a</parameter> contains no pages. As an example, if
835 <function>FcCharSetFirstPage</function> returns
836 <literal>0x300</literal> and fills <parameter>map</parameter> with
837 <literallayout class="monospaced">
838 0xffffffff 0xffffffff 0x01000008 0x44300002 0xffffd7f0 0xfffffffb 0xffff7fff 0xffff0003
840 Then the page contains code points <literal>0x300</literal> through
841 <literal>0x33f</literal> (the first 64 code points on the page)
842 because <parameter>map[0]</parameter> and
843 <parameter>map[1]</parameter> both have all their bits set. It also
844 contains code points <literal>0x343</literal> (<parameter>0x300 + 32*2
845 + (4-1)</parameter>) and <literal>0x35e</literal> (<parameter>0x300 +
846 32*2 + (31-1)</parameter>) because <parameter>map[2]</parameter> has
847 the 4th and 31st bits set. The code points represented by
848 <literal>map[3]</literal> and later are left as an excercise for the
854 fontconfig/doc/func.sgml
856 Copyright © 2003 Keith Packard
858 Permission to use, copy, modify, distribute, and sell this software and its
859 documentation for any purpose is hereby granted without fee, provided that
860 the above copyright notice appear in all copies and that both that
861 copyright notice and this permission notice appear in supporting
862 documentation, and that the name of the author(s) not be used in
863 advertising or publicity pertaining to distribution of the software without
864 specific, written prior permission. The authors make no
865 representations about the suitability of this software for any purpose. It
866 is provided "as is" without express or implied warranty.
868 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
869 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
870 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
871 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
872 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
873 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
874 PERFORMANCE OF THIS SOFTWARE.
876 <refentry id="FcCharSetNextPage">
878 <refentrytitle>FcCharSetNextPage</refentrytitle>
879 <manvolnum>3</manvolnum>
880 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
883 <refname>FcCharSetNextPage</refname>
884 <refpurpose>Continue enumerating charset contents</refpurpose>
889 #include <fontconfig/fontconfig.h>
892 <funcdef>FcChar32 <function>FcCharSetNextPage</function></funcdef>
893 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
894 <paramdef>FcChar32[FC_CHARSET_MAP_SIZE] <parameter>map</parameter></paramdef>
895 <paramdef>FcChar32 *<parameter>next</parameter></paramdef>
899 <refsect1><title>Description</title>
901 Builds an array of bits in <parameter>map</parameter> marking the
902 Unicode coverage of <parameter>a</parameter> for page containing
903 <parameter>*next</parameter> (see the
904 <function>FcCharSetFirstPage</function> description for details).
905 <parameter>*next</parameter> is set to contains the base code point
906 for the next page in <parameter>a</parameter>. Returns the base of
907 code point for the page, or <constant>FC_CHARSET_DONE</constant> if
908 <parameter>a</parameter> does not contain
909 <parameter>*next</parameter>.
914 fontconfig/doc/func.sgml
916 Copyright © 2003 Keith Packard
918 Permission to use, copy, modify, distribute, and sell this software and its
919 documentation for any purpose is hereby granted without fee, provided that
920 the above copyright notice appear in all copies and that both that
921 copyright notice and this permission notice appear in supporting
922 documentation, and that the name of the author(s) not be used in
923 advertising or publicity pertaining to distribution of the software without
924 specific, written prior permission. The authors make no
925 representations about the suitability of this software for any purpose. It
926 is provided "as is" without express or implied warranty.
928 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
929 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
930 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
931 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
932 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
933 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
934 PERFORMANCE OF THIS SOFTWARE.
936 <refentry id="FcCharSetCoverage">
938 <refentrytitle>FcCharSetCoverage</refentrytitle>
939 <manvolnum>3</manvolnum>
940 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
943 <refname>FcCharSetCoverage</refname>
944 <refpurpose>DEPRECATED return coverage for a Unicode page</refpurpose>
949 #include <fontconfig/fontconfig.h>
952 <funcdef>FcChar32 <function>FcCharSetCoverage</function></funcdef>
953 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
954 <paramdef>FcChar32<parameter>page</parameter></paramdef>
955 <paramdef>FcChar32[8]<parameter>result</parameter></paramdef>
959 <refsect1><title>Description</title>
962 This function returns a bitmask in <parameter>result</parameter> which
963 indicates which code points in
964 <parameter>page</parameter> are included in <parameter>a</parameter>.
965 <function>FcCharSetCoverage</function> returns the next page in the charset which has any
971 fontconfig/doc/func.sgml
973 Copyright © 2003 Keith Packard
975 Permission to use, copy, modify, distribute, and sell this software and its
976 documentation for any purpose is hereby granted without fee, provided that
977 the above copyright notice appear in all copies and that both that
978 copyright notice and this permission notice appear in supporting
979 documentation, and that the name of the author(s) not be used in
980 advertising or publicity pertaining to distribution of the software without
981 specific, written prior permission. The authors make no
982 representations about the suitability of this software for any purpose. It
983 is provided "as is" without express or implied warranty.
985 THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
986 INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
987 EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
988 CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
989 DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
990 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
991 PERFORMANCE OF THIS SOFTWARE.
993 <refentry id="FcCharSetNew">
995 <refentrytitle>FcCharSetNew</refentrytitle>
996 <manvolnum>3</manvolnum>
997 <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
1000 <refname>FcCharSetNew</refname>
1001 <refpurpose>DEPRECATED alias for FcCharSetCreate</refpurpose>
1006 #include <fontconfig/fontconfig.h>
1009 <funcdef>FcCharSet * <function>FcCharSetNew</function></funcdef>
1010 <paramdef>void<parameter></parameter></paramdef>
1014 <refsect1><title>Description</title>
1016 <function>FcCharSetNew</function> is a DEPRECATED alias for FcCharSetCreate.