fccharsetfirstpage.html revision a32e9e42 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<HTML
3><HEAD
4><TITLE
5>FcCharSetFirstPage</TITLE
6><META
7NAME="GENERATOR"
8CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9REL="HOME"
10HREF="t1.html"><LINK
11REL="UP"
12TITLE="FcCharSet"
13HREF="x103.html#AEN1869"><LINK
14REL="PREVIOUS"
15TITLE="FcCharSetIsSubset"
16HREF="fccharsetissubset.html"><LINK
17REL="NEXT"
18TITLE="FcCharSetNextPage"
19HREF="fccharsetnextpage.html"></HEAD
20><BODY
21CLASS="REFENTRY"
22BGCOLOR="#FFFFFF"
23TEXT="#000000"
24LINK="#0000FF"
25VLINK="#840084"
26ALINK="#0000FF"
27><DIV
28CLASS="NAVHEADER"
29><TABLE
30SUMMARY="Header navigation table"
31WIDTH="100%"
32BORDER="0"
33CELLPADDING="0"
34CELLSPACING="0"
35><TR
36><TH
37COLSPAN="3"
38ALIGN="center"
39></TH
40></TR
41><TR
42><TD
43WIDTH="10%"
44ALIGN="left"
45VALIGN="bottom"
46><A
47HREF="fccharsetissubset.html"
48ACCESSKEY="P"
49>&#60;&#60;&#60; Previous</A
50></TD
51><TD
52WIDTH="80%"
53ALIGN="center"
54VALIGN="bottom"
55></TD
56><TD
57WIDTH="10%"
58ALIGN="right"
59VALIGN="bottom"
60><A
61HREF="fccharsetnextpage.html"
62ACCESSKEY="N"
63>Next &#62;&#62;&#62;</A
64></TD
65></TR
66></TABLE
67><HR
68ALIGN="LEFT"
69WIDTH="100%"></DIV
70><H1
71><A
72NAME="FCCHARSETFIRSTPAGE"
73></A
74>FcCharSetFirstPage</H1
75><DIV
76CLASS="REFNAMEDIV"
77><A
78NAME="AEN2219"
79></A
80><H2
81>Name</H2
82>FcCharSetFirstPage&nbsp;--&nbsp;Start enumerating charset contents</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN2222"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN2223"
96></A
97><TABLE
98BORDER="0"
99BGCOLOR="#E0E0E0"
100WIDTH="100%"
101><TR
102><TD
103><PRE
104CLASS="FUNCSYNOPSISINFO"
105>#include &#60;fontconfig/fontconfig.h&#62;
106	</PRE
107></TD
108></TR
109></TABLE
110><P
111><CODE
112><CODE
113CLASS="FUNCDEF"
114>FcChar32 <TT
115CLASS="FUNCTION"
116>FcCharSetFirstPage</TT
117></CODE
118>(const FcCharSet *<TT
119CLASS="PARAMETER"
120><I
121>a</I
122></TT
123>, FcChar32[FC_CHARSET_MAP_SIZE] <TT
124CLASS="PARAMETER"
125><I
126>map</I
127></TT
128>, FcChar32 *<TT
129CLASS="PARAMETER"
130><I
131>next</I
132></TT
133>);</CODE
134></P
135><P
136></P
137></DIV
138></DIV
139><DIV
140CLASS="REFSECT1"
141><A
142NAME="AEN2234"
143></A
144><H2
145>Description</H2
146><P
147>Builds an array of bits in <TT
148CLASS="PARAMETER"
149><I
150>map</I
151></TT
152> marking the
153first page of Unicode coverage of <TT
154CLASS="PARAMETER"
155><I
156>a</I
157></TT
158>.
159<TT
160CLASS="PARAMETER"
161><I
162>*next</I
163></TT
164> is set to contains the base code point
165for the next page in <TT
166CLASS="PARAMETER"
167><I
168>a</I
169></TT
170>.  Returns the base code
171point for the page, or <CODE
172CLASS="CONSTANT"
173>FC_CHARSET_DONE</CODE
174> if
175<TT
176CLASS="PARAMETER"
177><I
178>a</I
179></TT
180> contains no pages.  As an example, if
181<TT
182CLASS="FUNCTION"
183>FcCharSetFirstPage</TT
184> returns
185<TT
186CLASS="LITERAL"
187>0x300</TT
188> and fills <TT
189CLASS="PARAMETER"
190><I
191>map</I
192></TT
193> with
194<TABLE
195BORDER="0"
196BGCOLOR="#E0E0E0"
197WIDTH="100%"
198><TR
199><TD
200><PRE
201CLASS="LITERALLAYOUT"
202>0xffffffff 0xffffffff 0x01000008 0x44300002 0xffffd7f0 0xfffffffb 0xffff7fff 0xffff0003</PRE
203></TD
204></TR
205></TABLE
206>
207Then the page contains code points <TT
208CLASS="LITERAL"
209>0x300</TT
210> through
211<TT
212CLASS="LITERAL"
213>0x33f</TT
214> (the first 64 code points on the page)
215because <TT
216CLASS="PARAMETER"
217><I
218>map[0]</I
219></TT
220> and
221<TT
222CLASS="PARAMETER"
223><I
224>map[1]</I
225></TT
226> both have all their bits set.  It also
227contains code points <TT
228CLASS="LITERAL"
229>0x343</TT
230> (<TT
231CLASS="PARAMETER"
232><I
233>0x300 + 32*2
234+ (4-1)</I
235></TT
236>) and <TT
237CLASS="LITERAL"
238>0x35e</TT
239> (<TT
240CLASS="PARAMETER"
241><I
242>0x300 +
24332*2 + (31-1)</I
244></TT
245>) because <TT
246CLASS="PARAMETER"
247><I
248>map[2]</I
249></TT
250> has
251the 4th and 31st bits set.  The code points represented by
252<TT
253CLASS="LITERAL"
254>map[3]</TT
255> and later are left as an excercise for the
256reader ;).
257	    </P
258></DIV
259><DIV
260CLASS="NAVFOOTER"
261><HR
262ALIGN="LEFT"
263WIDTH="100%"><TABLE
264SUMMARY="Footer navigation table"
265WIDTH="100%"
266BORDER="0"
267CELLPADDING="0"
268CELLSPACING="0"
269><TR
270><TD
271WIDTH="33%"
272ALIGN="left"
273VALIGN="top"
274><A
275HREF="fccharsetissubset.html"
276ACCESSKEY="P"
277>&#60;&#60;&#60; Previous</A
278></TD
279><TD
280WIDTH="34%"
281ALIGN="center"
282VALIGN="top"
283><A
284HREF="t1.html"
285ACCESSKEY="H"
286>Home</A
287></TD
288><TD
289WIDTH="33%"
290ALIGN="right"
291VALIGN="top"
292><A
293HREF="fccharsetnextpage.html"
294ACCESSKEY="N"
295>Next &#62;&#62;&#62;</A
296></TD
297></TR
298><TR
299><TD
300WIDTH="33%"
301ALIGN="left"
302VALIGN="top"
303>FcCharSetIsSubset</TD
304><TD
305WIDTH="34%"
306ALIGN="center"
307VALIGN="top"
308><A
309HREF="x103.html#AEN1869"
310ACCESSKEY="U"
311>Up</A
312></TD
313><TD
314WIDTH="33%"
315ALIGN="right"
316VALIGN="top"
317>FcCharSetNextPage</TD
318></TR
319></TABLE
320></DIV
321></BODY
322></HTML
323>