doc/fccharset.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="FcCharSetCreate">
  25         <refmeta>
  26             <refentrytitle>FcCharSetCreate</refentrytitle>
  27             <manvolnum>3</manvolnum>
  28             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
  29         </refmeta>
  30         <refnamediv>
  31             <refname>FcCharSetCreate</refname>
  32             <refpurpose>Create an empty character set</refpurpose>
  33         </refnamediv>
  34         <refsynopsisdiv>
  35         <funcsynopsis>
  36         <funcsynopsisinfo>
  37 #include &lt;fontconfig/fontconfig.h&gt;
  38         </funcsynopsisinfo>
  39         <funcprototype>
  40             <funcdef>FcCharSet * <function>FcCharSetCreate</function></funcdef>
  41                 <paramdef>void<parameter></parameter></paramdef>
  42         </funcprototype>
  43         </funcsynopsis>
  44         </refsynopsisdiv>
  45         <refsect1><title>Description</title>
  46             <para>
  47 <function>FcCharSetCreate</function> allocates and initializes a new empty
  48 character set object.
  49             </para>
  50         </refsect1>
  51     </refentry>
  52 <!--
  53    fontconfig/doc/func.sgml
  54
  55    Copyright © 2003 Keith Packard
  56
  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.
  66
  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.
  74  -->
  75     <refentry id="FcCharSetDestroy">
  76         <refmeta>
  77             <refentrytitle>FcCharSetDestroy</refentrytitle>
  78             <manvolnum>3</manvolnum>
  79             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
  80         </refmeta>
  81         <refnamediv>
  82             <refname>FcCharSetDestroy</refname>
  83             <refpurpose>Destroy a character set</refpurpose>
  84         </refnamediv>
  85         <refsynopsisdiv>
  86         <funcsynopsis>
  87         <funcsynopsisinfo>
  88 #include &lt;fontconfig/fontconfig.h&gt;
  89         </funcsynopsisinfo>
  90         <funcprototype>
  91             <funcdef>void <function>FcCharSetDestroy</function></funcdef>
  92                 <paramdef>FcCharSet *<parameter>fcs</parameter></paramdef>
  93         </funcprototype>
  94         </funcsynopsis>
  95         </refsynopsisdiv>
  96         <refsect1><title>Description</title>
  97             <para>
  98 <function>FcCharSetDestroy</function> decrements the reference count
  99 <parameter>fcs</parameter>.  If the reference count becomes zero, all
 100 memory referenced is freed.
 101             </para>
 102         </refsect1>
 103     </refentry>
 104 <!--
 105    fontconfig/doc/func.sgml
 106
 107    Copyright © 2003 Keith Packard
 108
 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.
 118
 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.
 126  -->
 127     <refentry id="FcCharSetAddChar">
 128         <refmeta>
 129             <refentrytitle>FcCharSetAddChar</refentrytitle>
 130             <manvolnum>3</manvolnum>
 131             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 132         </refmeta>
 133         <refnamediv>
 134             <refname>FcCharSetAddChar</refname>
 135             <refpurpose>Add a character to a charset</refpurpose>
 136         </refnamediv>
 137         <refsynopsisdiv>
 138         <funcsynopsis>
 139         <funcsynopsisinfo>
 140 #include &lt;fontconfig/fontconfig.h&gt;
 141         </funcsynopsisinfo>
 142         <funcprototype>
 143             <funcdef>FcBool <function>FcCharSetAddChar</function></funcdef>
 144                 <paramdef>FcCharSet *<parameter>fcs</parameter></paramdef>
 145                 <paramdef>FcChar32 <parameter>ucs4</parameter></paramdef>
 146         </funcprototype>
 147         </funcsynopsis>
 148         </refsynopsisdiv>
 149         <refsect1><title>Description</title>
 150             <para>
 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.
 154             </para>
 155         </refsect1>
 156     </refentry>
 157 <!--
 158    fontconfig/doc/func.sgml
 159
 160    Copyright © 2003 Keith Packard
 161
 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.
 171
 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.
 179  -->
 180     <refentry id="FcCharSetDelChar">
 181         <refmeta>
 182             <refentrytitle>FcCharSetDelChar</refentrytitle>
 183             <manvolnum>3</manvolnum>
 184             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 185         </refmeta>
 186         <refnamediv>
 187             <refname>FcCharSetDelChar</refname>
 188             <refpurpose>Add a character to a charset</refpurpose>
 189         </refnamediv>
 190         <refsynopsisdiv>
 191         <funcsynopsis>
 192         <funcsynopsisinfo>
 193 #include &lt;fontconfig/fontconfig.h&gt;
 194         </funcsynopsisinfo>
 195         <funcprototype>
 196             <funcdef>FcBool <function>FcCharSetDelChar</function></funcdef>
 197                 <paramdef>FcCharSet *<parameter>fcs</parameter></paramdef>
 198                 <paramdef>FcChar32 <parameter>ucs4</parameter></paramdef>
 199         </funcprototype>
 200         </funcsynopsis>
 201         </refsynopsisdiv>
 202         <refsect1><title>Description</title>
 203             <para>
 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.
 207             </para>
 208         </refsect1>
 209         <refsect1><title>Since</title>
 210             <para>version 2.9.0</para>
 211         </refsect1>
 212     </refentry>
 213 <!--
 214    fontconfig/doc/func.sgml
 215
 216    Copyright © 2003 Keith Packard
 217
 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.
 227
 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.
 235  -->
 236     <refentry id="FcCharSetCopy">
 237         <refmeta>
 238             <refentrytitle>FcCharSetCopy</refentrytitle>
 239             <manvolnum>3</manvolnum>
 240             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 241         </refmeta>
 242         <refnamediv>
 243             <refname>FcCharSetCopy</refname>
 244             <refpurpose>Copy a charset</refpurpose>
 245         </refnamediv>
 246         <refsynopsisdiv>
 247         <funcsynopsis>
 248         <funcsynopsisinfo>
 249 #include &lt;fontconfig/fontconfig.h&gt;
 250         </funcsynopsisinfo>
 251         <funcprototype>
 252             <funcdef>FcCharSet * <function>FcCharSetCopy</function></funcdef>
 253                 <paramdef>FcCharSet *<parameter>src</parameter></paramdef>
 254         </funcprototype>
 255         </funcsynopsis>
 256         </refsynopsisdiv>
 257         <refsect1><title>Description</title>
 258             <para>
 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>.
 261             </para>
 262         </refsect1>
 263     </refentry>
 264 <!--
 265    fontconfig/doc/func.sgml
 266
 267    Copyright © 2003 Keith Packard
 268
 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.
 278
 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.
 286  -->
 287     <refentry id="FcCharSetEqual">
 288         <refmeta>
 289             <refentrytitle>FcCharSetEqual</refentrytitle>
 290             <manvolnum>3</manvolnum>
 291             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 292         </refmeta>
 293         <refnamediv>
 294             <refname>FcCharSetEqual</refname>
 295             <refpurpose>Compare two charsets</refpurpose>
 296         </refnamediv>
 297         <refsynopsisdiv>
 298         <funcsynopsis>
 299         <funcsynopsisinfo>
 300 #include &lt;fontconfig/fontconfig.h&gt;
 301         </funcsynopsisinfo>
 302         <funcprototype>
 303             <funcdef>FcBool <function>FcCharSetEqual</function></funcdef>
 304                 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
 305                 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
 306         </funcprototype>
 307         </funcsynopsis>
 308         </refsynopsisdiv>
 309         <refsect1><title>Description</title>
 310             <para>
 311 Returns whether <parameter>a</parameter> and <parameter>b</parameter>
 312 contain the same set of Unicode chars.
 313             </para>
 314         </refsect1>
 315     </refentry>
 316 <!--
 317    fontconfig/doc/func.sgml
 318
 319    Copyright © 2003 Keith Packard
 320
 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.
 330
 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.
 338  -->
 339     <refentry id="FcCharSetIntersect">
 340         <refmeta>
 341             <refentrytitle>FcCharSetIntersect</refentrytitle>
 342             <manvolnum>3</manvolnum>
 343             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 344         </refmeta>
 345         <refnamediv>
 346             <refname>FcCharSetIntersect</refname>
 347             <refpurpose>Intersect charsets</refpurpose>
 348         </refnamediv>
 349         <refsynopsisdiv>
 350         <funcsynopsis>
 351         <funcsynopsisinfo>
 352 #include &lt;fontconfig/fontconfig.h&gt;
 353         </funcsynopsisinfo>
 354         <funcprototype>
 355             <funcdef>FcCharSet * <function>FcCharSetIntersect</function></funcdef>
 356                 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
 357                 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
 358         </funcprototype>
 359         </funcsynopsis>
 360         </refsynopsisdiv>
 361         <refsect1><title>Description</title>
 362             <para>
 363 Returns a set including only those chars found in both
 364 <parameter>a</parameter> and <parameter>b</parameter>.
 365             </para>
 366         </refsect1>
 367     </refentry>
 368 <!--
 369    fontconfig/doc/func.sgml
 370
 371    Copyright © 2003 Keith Packard
 372
 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.
 382
 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.
 390  -->
 391     <refentry id="FcCharSetUnion">
 392         <refmeta>
 393             <refentrytitle>FcCharSetUnion</refentrytitle>
 394             <manvolnum>3</manvolnum>
 395             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 396         </refmeta>
 397         <refnamediv>
 398             <refname>FcCharSetUnion</refname>
 399             <refpurpose>Add charsets</refpurpose>
 400         </refnamediv>
 401         <refsynopsisdiv>
 402         <funcsynopsis>
 403         <funcsynopsisinfo>
 404 #include &lt;fontconfig/fontconfig.h&gt;
 405         </funcsynopsisinfo>
 406         <funcprototype>
 407             <funcdef>FcCharSet * <function>FcCharSetUnion</function></funcdef>
 408                 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
 409                 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
 410         </funcprototype>
 411         </funcsynopsis>
 412         </refsynopsisdiv>
 413         <refsect1><title>Description</title>
 414             <para>
 415 Returns a set including only those chars found in either <parameter>a</parameter> or <parameter>b</parameter>.
 416             </para>
 417         </refsect1>
 418     </refentry>
 419 <!--
 420    fontconfig/doc/func.sgml
 421
 422    Copyright © 2003 Keith Packard
 423
 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.
 433
 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.
 441  -->
 442     <refentry id="FcCharSetSubtract">
 443         <refmeta>
 444             <refentrytitle>FcCharSetSubtract</refentrytitle>
 445             <manvolnum>3</manvolnum>
 446             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 447         </refmeta>
 448         <refnamediv>
 449             <refname>FcCharSetSubtract</refname>
 450             <refpurpose>Subtract charsets</refpurpose>
 451         </refnamediv>
 452         <refsynopsisdiv>
 453         <funcsynopsis>
 454         <funcsynopsisinfo>
 455 #include &lt;fontconfig/fontconfig.h&gt;
 456         </funcsynopsisinfo>
 457         <funcprototype>
 458             <funcdef>FcCharSet * <function>FcCharSetSubtract</function></funcdef>
 459                 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
 460                 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
 461         </funcprototype>
 462         </funcsynopsis>
 463         </refsynopsisdiv>
 464         <refsect1><title>Description</title>
 465             <para>
 466 Returns a set including only those chars found in <parameter>a</parameter> but not <parameter>b</parameter>.
 467             </para>
 468         </refsect1>
 469     </refentry>
 470 <!--
 471    fontconfig/doc/func.sgml
 472
 473    Copyright © 2003 Keith Packard
 474
 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.
 484
 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.
 492  -->
 493     <refentry id="FcCharSetMerge">
 494         <refmeta>
 495             <refentrytitle>FcCharSetMerge</refentrytitle>
 496             <manvolnum>3</manvolnum>
 497             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 498         </refmeta>
 499         <refnamediv>
 500             <refname>FcCharSetMerge</refname>
 501             <refpurpose>Merge charsets</refpurpose>
 502         </refnamediv>
 503         <refsynopsisdiv>
 504         <funcsynopsis>
 505         <funcsynopsisinfo>
 506 #include &lt;fontconfig/fontconfig.h&gt;
 507         </funcsynopsisinfo>
 508         <funcprototype>
 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>
 513         </funcprototype>
 514         </funcsynopsis>
 515         </refsynopsisdiv>
 516         <refsect1><title>Description</title>
 517             <para>
 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.
 524             </para>
 525         </refsect1>
 526     </refentry>
 527 <!--
 528    fontconfig/doc/func.sgml
 529
 530    Copyright © 2003 Keith Packard
 531
 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.
 541
 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.
 549  -->
 550     <refentry id="FcCharSetHasChar">
 551         <refmeta>
 552             <refentrytitle>FcCharSetHasChar</refentrytitle>
 553             <manvolnum>3</manvolnum>
 554             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 555         </refmeta>
 556         <refnamediv>
 557             <refname>FcCharSetHasChar</refname>
 558             <refpurpose>Check a charset for a char</refpurpose>
 559         </refnamediv>
 560         <refsynopsisdiv>
 561         <funcsynopsis>
 562         <funcsynopsisinfo>
 563 #include &lt;fontconfig/fontconfig.h&gt;
 564         </funcsynopsisinfo>
 565         <funcprototype>
 566             <funcdef>FcBool <function>FcCharSetHasChar</function></funcdef>
 567                 <paramdef>const FcCharSet *<parameter>fcs</parameter></paramdef>
 568                 <paramdef>FcChar32 <parameter>ucs4</parameter></paramdef>
 569         </funcprototype>
 570         </funcsynopsis>
 571         </refsynopsisdiv>
 572         <refsect1><title>Description</title>
 573             <para>
 574 Returns whether <parameter>fcs</parameter> contains the char <parameter>ucs4</parameter>.
 575             </para>
 576         </refsect1>
 577     </refentry>
 578 <!--
 579    fontconfig/doc/func.sgml
 580
 581    Copyright © 2003 Keith Packard
 582
 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.
 592
 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.
 600  -->
 601     <refentry id="FcCharSetCount">
 602         <refmeta>
 603             <refentrytitle>FcCharSetCount</refentrytitle>
 604             <manvolnum>3</manvolnum>
 605             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 606         </refmeta>
 607         <refnamediv>
 608             <refname>FcCharSetCount</refname>
 609             <refpurpose>Count entries in a charset</refpurpose>
 610         </refnamediv>
 611         <refsynopsisdiv>
 612         <funcsynopsis>
 613         <funcsynopsisinfo>
 614 #include &lt;fontconfig/fontconfig.h&gt;
 615         </funcsynopsisinfo>
 616         <funcprototype>
 617             <funcdef>FcChar32 <function>FcCharSetCount</function></funcdef>
 618                 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
 619         </funcprototype>
 620         </funcsynopsis>
 621         </refsynopsisdiv>
 622         <refsect1><title>Description</title>
 623             <para>
 624 Returns the total number of Unicode chars in <parameter>a</parameter>.
 625             </para>
 626         </refsect1>
 627     </refentry>
 628 <!--
 629    fontconfig/doc/func.sgml
 630
 631    Copyright © 2003 Keith Packard
 632
 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.
 642
 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.
 650  -->
 651     <refentry id="FcCharSetIntersectCount">
 652         <refmeta>
 653             <refentrytitle>FcCharSetIntersectCount</refentrytitle>
 654             <manvolnum>3</manvolnum>
 655             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 656         </refmeta>
 657         <refnamediv>
 658             <refname>FcCharSetIntersectCount</refname>
 659             <refpurpose>Intersect and count charsets</refpurpose>
 660         </refnamediv>
 661         <refsynopsisdiv>
 662         <funcsynopsis>
 663         <funcsynopsisinfo>
 664 #include &lt;fontconfig/fontconfig.h&gt;
 665         </funcsynopsisinfo>
 666         <funcprototype>
 667             <funcdef>FcChar32 <function>FcCharSetIntersectCount</function></funcdef>
 668                 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
 669                 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
 670         </funcprototype>
 671         </funcsynopsis>
 672         </refsynopsisdiv>
 673         <refsect1><title>Description</title>
 674             <para>
 675 Returns the number of chars that are in both <parameter>a</parameter> and <parameter>b</parameter>.
 676             </para>
 677         </refsect1>
 678     </refentry>
 679 <!--
 680    fontconfig/doc/func.sgml
 681
 682    Copyright © 2003 Keith Packard
 683
 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.
 693
 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.
 701  -->
 702     <refentry id="FcCharSetSubtractCount">
 703         <refmeta>
 704             <refentrytitle>FcCharSetSubtractCount</refentrytitle>
 705             <manvolnum>3</manvolnum>
 706             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 707         </refmeta>
 708         <refnamediv>
 709             <refname>FcCharSetSubtractCount</refname>
 710             <refpurpose>Subtract and count charsets</refpurpose>
 711         </refnamediv>
 712         <refsynopsisdiv>
 713         <funcsynopsis>
 714         <funcsynopsisinfo>
 715 #include &lt;fontconfig/fontconfig.h&gt;
 716         </funcsynopsisinfo>
 717         <funcprototype>
 718             <funcdef>FcChar32 <function>FcCharSetSubtractCount</function></funcdef>
 719                 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
 720                 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
 721         </funcprototype>
 722         </funcsynopsis>
 723         </refsynopsisdiv>
 724         <refsect1><title>Description</title>
 725             <para>
 726 Returns the number of chars that are in <parameter>a</parameter> but not in <parameter>b</parameter>.
 727             </para>
 728         </refsect1>
 729     </refentry>
 730 <!--
 731    fontconfig/doc/func.sgml
 732
 733    Copyright © 2003 Keith Packard
 734
 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.
 744
 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.
 752  -->
 753     <refentry id="FcCharSetIsSubset">
 754         <refmeta>
 755             <refentrytitle>FcCharSetIsSubset</refentrytitle>
 756             <manvolnum>3</manvolnum>
 757             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 758         </refmeta>
 759         <refnamediv>
 760             <refname>FcCharSetIsSubset</refname>
 761             <refpurpose>Test for charset inclusion</refpurpose>
 762         </refnamediv>
 763         <refsynopsisdiv>
 764         <funcsynopsis>
 765         <funcsynopsisinfo>
 766 #include &lt;fontconfig/fontconfig.h&gt;
 767         </funcsynopsisinfo>
 768         <funcprototype>
 769             <funcdef>FcBool <function>FcCharSetIsSubset</function></funcdef>
 770                 <paramdef>const FcCharSet *<parameter>a</parameter></paramdef>
 771                 <paramdef>const FcCharSet *<parameter>b</parameter></paramdef>
 772         </funcprototype>
 773         </funcsynopsis>
 774         </refsynopsisdiv>
 775         <refsect1><title>Description</title>
 776             <para>
 777 Returns whether <parameter>a</parameter> is a subset of <parameter>b</parameter>.
 778             </para>
 779         </refsect1>
 780     </refentry>
 781 <!--
 782    fontconfig/doc/func.sgml
 783
 784    Copyright © 2003 Keith Packard
 785
 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.
 795
 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.
 803  -->
 804     <refentry id="FcCharSetFirstPage">
 805         <refmeta>
 806             <refentrytitle>FcCharSetFirstPage</refentrytitle>
 807             <manvolnum>3</manvolnum>
 808             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 809         </refmeta>
 810         <refnamediv>
 811             <refname>FcCharSetFirstPage</refname>
 812             <refpurpose>Start enumerating charset contents</refpurpose>
 813         </refnamediv>
 814         <refsynopsisdiv>
 815         <funcsynopsis>
 816         <funcsynopsisinfo>
 817 #include &lt;fontconfig/fontconfig.h&gt;
 818         </funcsynopsisinfo>
 819         <funcprototype>
 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>
 824         </funcprototype>
 825         </funcsynopsis>
 826         </refsynopsisdiv>
 827         <refsect1><title>Description</title>
 828             <para>
 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
 839 </literallayout>
 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
 849 reader ;).
 850             </para>
 851         </refsect1>
 852     </refentry>
 853 <!--
 854    fontconfig/doc/func.sgml
 855
 856    Copyright © 2003 Keith Packard
 857
 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.
 867
 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.
 875  -->
 876     <refentry id="FcCharSetNextPage">
 877         <refmeta>
 878             <refentrytitle>FcCharSetNextPage</refentrytitle>
 879             <manvolnum>3</manvolnum>
 880             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 881         </refmeta>
 882         <refnamediv>
 883             <refname>FcCharSetNextPage</refname>
 884             <refpurpose>Continue enumerating charset contents</refpurpose>
 885         </refnamediv>
 886         <refsynopsisdiv>
 887         <funcsynopsis>
 888         <funcsynopsisinfo>
 889 #include &lt;fontconfig/fontconfig.h&gt;
 890         </funcsynopsisinfo>
 891         <funcprototype>
 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>
 896         </funcprototype>
 897         </funcsynopsis>
 898         </refsynopsisdiv>
 899         <refsect1><title>Description</title>
 900             <para>
 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>.
 910             </para>
 911         </refsect1>
 912     </refentry>
 913 <!--
 914    fontconfig/doc/func.sgml
 915
 916    Copyright © 2003 Keith Packard
 917
 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.
 927
 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.
 935  -->
 936     <refentry id="FcCharSetCoverage">
 937         <refmeta>
 938             <refentrytitle>FcCharSetCoverage</refentrytitle>
 939             <manvolnum>3</manvolnum>
 940             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 941         </refmeta>
 942         <refnamediv>
 943             <refname>FcCharSetCoverage</refname>
 944             <refpurpose>DEPRECATED return coverage for a Unicode page</refpurpose>
 945         </refnamediv>
 946         <refsynopsisdiv>
 947         <funcsynopsis>
 948         <funcsynopsisinfo>
 949 #include &lt;fontconfig/fontconfig.h&gt;
 950         </funcsynopsisinfo>
 951         <funcprototype>
 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>
 956         </funcprototype>
 957         </funcsynopsis>
 958         </refsynopsisdiv>
 959         <refsect1><title>Description</title>
 960             <para>
 961 DEPRECATED
 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
 966 coverage.
 967             </para>
 968         </refsect1>
 969     </refentry>
 970 <!--
 971    fontconfig/doc/func.sgml
 972
 973    Copyright © 2003 Keith Packard
 974
 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.
 984
 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.
 992  -->
 993     <refentry id="FcCharSetNew">
 994         <refmeta>
 995             <refentrytitle>FcCharSetNew</refentrytitle>
 996             <manvolnum>3</manvolnum>
 997             <refmiscinfo class="software">Fontconfig &version;</refmiscinfo>
 998         </refmeta>
 999         <refnamediv>
1000             <refname>FcCharSetNew</refname>
1001             <refpurpose>DEPRECATED alias for FcCharSetCreate</refpurpose>
1002         </refnamediv>
1003         <refsynopsisdiv>
1004         <funcsynopsis>
1005         <funcsynopsisinfo>
1006 #include &lt;fontconfig/fontconfig.h&gt;
1007         </funcsynopsisinfo>
1008         <funcprototype>
1009             <funcdef>FcCharSet * <function>FcCharSetNew</function></funcdef>
1010                 <paramdef>void<parameter></parameter></paramdef>
1011         </funcprototype>
1012         </funcsynopsis>
1013         </refsynopsisdiv>
1014         <refsect1><title>Description</title>
1015             <para>
1016 <function>FcCharSetNew</function> is a DEPRECATED alias for FcCharSetCreate.
1017             </para>
1018         </refsect1>
1019     </refentry>