doc/FcCharSetFirstPage.3

   1 .\" auto-generated by docbook2man-spec from docbook-utils package
   2 .TH "FcCharSetFirstPage" "3" "09 3月 2015" "Fontconfig 2.11.93" ""
   3 .SH NAME
   4 FcCharSetFirstPage \- Start enumerating charset contents
   5 .SH SYNOPSIS
   6 .nf
   7 \fB#include <fontconfig/fontconfig.h>
   8 .sp
   9 FcChar32 FcCharSetFirstPage (const FcCharSet *\fIa\fB, FcChar32[FC_CHARSET_MAP_SIZE] \fImap\fB, FcChar32 *\fInext\fB);
  10 .fi\fR
  11 .SH "DESCRIPTION"
  12 .PP
  13 Builds an array of bits in \fImap\fR marking the
  14 first page of Unicode coverage of \fIa\fR\&.
  15 \fI*next\fR is set to contains the base code point
  16 for the next page in \fIa\fR\&. Returns the base code
  17 point for the page, or FC_CHARSET_DONE if
  18 \fIa\fR contains no pages. As an example, if
  19 \fBFcCharSetFirstPage\fR returns
  20 0x300 and fills \fImap\fR with
  21 .sp
  22 .nf
  23 0xffffffff 0xffffffff 0x01000008 0x44300002 0xffffd7f0 0xfffffffb 0xffff7fff 0xffff0003
  24 .sp
  25 .fi
  26 Then the page contains code points 0x300 through
  27 0x33f (the first 64 code points on the page)
  28 because \fImap[0]\fR and
  29 \fImap[1]\fR both have all their bits set. It also
  30 contains code points 0x343 (\fI0x300 + 32*2
  31 + (4-1)\fR) and 0x35e (\fI0x300 +
  32 32*2 + (31-1)\fR) because \fImap[2]\fR has
  33 the 4th and 31st bits set. The code points represented by
  34 map[3] and later are left as an excercise for the
  35 reader ;).