xenocara/dist/fontconfig/doc/FcCharSetFirstPage.3

36 lines
1.2 KiB
Groff

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