fccharsetfirstpage.html revision 6fc018e4 
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="x102.html#AEN1616"><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="AEN1992"
79></A
80><H2
81>Name</H2
82>FcCharSetFirstPage&nbsp;--&nbsp;Start enumerating charset contents</DIV
83><DIV
84CLASS="REFSYNOPSISDIV"
85><A
86NAME="AEN1995"
87></A
88><H2
89>Synopsis</H2
90><DIV
91CLASS="FUNCSYNOPSIS"
92><P
93></P
94><A
95NAME="AEN1996"
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="AEN2007"
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="REFSECT1"
261><A
262NAME="AEN2030"
263></A
264><H2
265>Version</H2
266><P
267>Fontconfig version 2.11.0
268
269	    </P
270></DIV
271><DIV
272CLASS="NAVFOOTER"
273><HR
274ALIGN="LEFT"
275WIDTH="100%"><TABLE
276SUMMARY="Footer navigation table"
277WIDTH="100%"
278BORDER="0"
279CELLPADDING="0"
280CELLSPACING="0"
281><TR
282><TD
283WIDTH="33%"
284ALIGN="left"
285VALIGN="top"
286><A
287HREF="fccharsetissubset.html"
288ACCESSKEY="P"
289>&#60;&#60;&#60; Previous</A
290></TD
291><TD
292WIDTH="34%"
293ALIGN="center"
294VALIGN="top"
295><A
296HREF="t1.html"
297ACCESSKEY="H"
298>Home</A
299></TD
300><TD
301WIDTH="33%"
302ALIGN="right"
303VALIGN="top"
304><A
305HREF="fccharsetnextpage.html"
306ACCESSKEY="N"
307>Next &#62;&#62;&#62;</A
308></TD
309></TR
310><TR
311><TD
312WIDTH="33%"
313ALIGN="left"
314VALIGN="top"
315>FcCharSetIsSubset</TD
316><TD
317WIDTH="34%"
318ALIGN="center"
319VALIGN="top"
320><A
321HREF="x102.html#AEN1616"
322ACCESSKEY="U"
323>Up</A
324></TD
325><TD
326WIDTH="33%"
327ALIGN="right"
328VALIGN="top"
329>FcCharSetNextPage</TD
330></TR
331></TABLE
332></DIV
333></BODY
334></HTML
335>