fccharsetfirstpage.html revision 1cc69409 
1a6844aabSmrg<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
2a6844aabSmrg<HTML
3a6844aabSmrg><HEAD
4a6844aabSmrg><TITLE
5a6844aabSmrg>FcCharSetFirstPage</TITLE
6a6844aabSmrg><META
7a6844aabSmrgNAME="GENERATOR"
8a6844aabSmrgCONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9a6844aabSmrgREL="HOME"
10a6844aabSmrgHREF="t1.html"><LINK
11a6844aabSmrgREL="UP"
12a6844aabSmrgTITLE="FcCharSet"
13a32e9e42SmrgHREF="x103.html#AEN1869"><LINK
14a6844aabSmrgREL="PREVIOUS"
15a6844aabSmrgTITLE="FcCharSetIsSubset"
16a6844aabSmrgHREF="fccharsetissubset.html"><LINK
17a6844aabSmrgREL="NEXT"
18a6844aabSmrgTITLE="FcCharSetNextPage"
19a6844aabSmrgHREF="fccharsetnextpage.html"></HEAD
20a6844aabSmrg><BODY
21a6844aabSmrgCLASS="REFENTRY"
22a6844aabSmrgBGCOLOR="#FFFFFF"
23a6844aabSmrgTEXT="#000000"
24a6844aabSmrgLINK="#0000FF"
25a6844aabSmrgVLINK="#840084"
26a6844aabSmrgALINK="#0000FF"
27a6844aabSmrg><DIV
28a6844aabSmrgCLASS="NAVHEADER"
29a6844aabSmrg><TABLE
30a6844aabSmrgSUMMARY="Header navigation table"
31a6844aabSmrgWIDTH="100%"
32a6844aabSmrgBORDER="0"
33a6844aabSmrgCELLPADDING="0"
34a6844aabSmrgCELLSPACING="0"
35a6844aabSmrg><TR
36a6844aabSmrg><TH
37a6844aabSmrgCOLSPAN="3"
38a6844aabSmrgALIGN="center"
39a6844aabSmrg></TH
40a6844aabSmrg></TR
41a6844aabSmrg><TR
42a6844aabSmrg><TD
43a6844aabSmrgWIDTH="10%"
44a6844aabSmrgALIGN="left"
45a6844aabSmrgVALIGN="bottom"
46a6844aabSmrg><A
47a6844aabSmrgHREF="fccharsetissubset.html"
48a6844aabSmrgACCESSKEY="P"
49a6844aabSmrg>&#60;&#60;&#60; Previous</A
50a6844aabSmrg></TD
51a6844aabSmrg><TD
52a6844aabSmrgWIDTH="80%"
53a6844aabSmrgALIGN="center"
54a6844aabSmrgVALIGN="bottom"
55a6844aabSmrg></TD
56a6844aabSmrg><TD
57a6844aabSmrgWIDTH="10%"
58a6844aabSmrgALIGN="right"
59a6844aabSmrgVALIGN="bottom"
60a6844aabSmrg><A
61a6844aabSmrgHREF="fccharsetnextpage.html"
62a6844aabSmrgACCESSKEY="N"
63a6844aabSmrg>Next &#62;&#62;&#62;</A
64a6844aabSmrg></TD
65a6844aabSmrg></TR
66a6844aabSmrg></TABLE
67a6844aabSmrg><HR
68a6844aabSmrgALIGN="LEFT"
69a6844aabSmrgWIDTH="100%"></DIV
70a6844aabSmrg><H1
71a6844aabSmrg><A
72a6844aabSmrgNAME="FCCHARSETFIRSTPAGE"
73a6844aabSmrg></A
74a6844aabSmrg>FcCharSetFirstPage</H1
75a6844aabSmrg><DIV
76a6844aabSmrgCLASS="REFNAMEDIV"
77a6844aabSmrg><A
78a32e9e42SmrgNAME="AEN2219"
79a6844aabSmrg></A
80a6844aabSmrg><H2
81a6844aabSmrg>Name</H2
82a6844aabSmrg>FcCharSetFirstPage&nbsp;--&nbsp;Start enumerating charset contents</DIV
83a6844aabSmrg><DIV
84a6844aabSmrgCLASS="REFSYNOPSISDIV"
85a6844aabSmrg><A
86a32e9e42SmrgNAME="AEN2222"
87a6844aabSmrg></A
88a6844aabSmrg><H2
89a6844aabSmrg>Synopsis</H2
90a6844aabSmrg><DIV
91a6844aabSmrgCLASS="FUNCSYNOPSIS"
92a6844aabSmrg><P
93a6844aabSmrg></P
94a6844aabSmrg><A
95a32e9e42SmrgNAME="AEN2223"
96a6844aabSmrg></A
97a6844aabSmrg><TABLE
98a6844aabSmrgBORDER="0"
99a6844aabSmrgBGCOLOR="#E0E0E0"
100a6844aabSmrgWIDTH="100%"
101a6844aabSmrg><TR
102a6844aabSmrg><TD
103a6844aabSmrg><PRE
104a6844aabSmrgCLASS="FUNCSYNOPSISINFO"
105c9710b42Smrg>#include &#60;fontconfig/fontconfig.h&#62;
1061cc69409Smrg        </PRE
107a6844aabSmrg></TD
108a6844aabSmrg></TR
109a6844aabSmrg></TABLE
110a6844aabSmrg><P
111a6844aabSmrg><CODE
112a6844aabSmrg><CODE
113a6844aabSmrgCLASS="FUNCDEF"
114a6844aabSmrg>FcChar32 <TT
115a6844aabSmrgCLASS="FUNCTION"
116a6844aabSmrg>FcCharSetFirstPage</TT
117a6844aabSmrg></CODE
118a6844aabSmrg>(const FcCharSet *<TT
119a6844aabSmrgCLASS="PARAMETER"
120a6844aabSmrg><I
121a6844aabSmrg>a</I
122a6844aabSmrg></TT
123a6844aabSmrg>, FcChar32[FC_CHARSET_MAP_SIZE] <TT
124a6844aabSmrgCLASS="PARAMETER"
125a6844aabSmrg><I
126a6844aabSmrg>map</I
127a6844aabSmrg></TT
128a6844aabSmrg>, FcChar32 *<TT
129a6844aabSmrgCLASS="PARAMETER"
130a6844aabSmrg><I
131a6844aabSmrg>next</I
132a6844aabSmrg></TT
133a6844aabSmrg>);</CODE
134a6844aabSmrg></P
135a6844aabSmrg><P
136a6844aabSmrg></P
137a6844aabSmrg></DIV
138a6844aabSmrg></DIV
139a6844aabSmrg><DIV
140a6844aabSmrgCLASS="REFSECT1"
141a6844aabSmrg><A
142a32e9e42SmrgNAME="AEN2234"
143a6844aabSmrg></A
144a6844aabSmrg><H2
145a6844aabSmrg>Description</H2
146a6844aabSmrg><P
1476fc018e4Smrg>Builds an array of bits in <TT
1486fc018e4SmrgCLASS="PARAMETER"
1496fc018e4Smrg><I
1506fc018e4Smrg>map</I
1516fc018e4Smrg></TT
1526fc018e4Smrg> marking the
1536fc018e4Smrgfirst page of Unicode coverage of <TT
1546fc018e4SmrgCLASS="PARAMETER"
1556fc018e4Smrg><I
1566fc018e4Smrg>a</I
1576fc018e4Smrg></TT
1586fc018e4Smrg>.
159a6844aabSmrg<TT
160a6844aabSmrgCLASS="PARAMETER"
161a6844aabSmrg><I
1626fc018e4Smrg>*next</I
1636fc018e4Smrg></TT
1646fc018e4Smrg> is set to contains the base code point
1656fc018e4Smrgfor the next page in <TT
1666fc018e4SmrgCLASS="PARAMETER"
1676fc018e4Smrg><I
168a6844aabSmrg>a</I
169a6844aabSmrg></TT
1706fc018e4Smrg>.  Returns the base code
1716fc018e4Smrgpoint for the page, or <CODE
1726fc018e4SmrgCLASS="CONSTANT"
1736fc018e4Smrg>FC_CHARSET_DONE</CODE
1746fc018e4Smrg> if
1756fc018e4Smrg<TT
176a6844aabSmrgCLASS="PARAMETER"
177a6844aabSmrg><I
1786fc018e4Smrg>a</I
1796fc018e4Smrg></TT
1806fc018e4Smrg> contains no pages.  As an example, if
1816fc018e4Smrg<TT
1826fc018e4SmrgCLASS="FUNCTION"
1836fc018e4Smrg>FcCharSetFirstPage</TT
1846fc018e4Smrg> returns
1856fc018e4Smrg<TT
1866fc018e4SmrgCLASS="LITERAL"
1876fc018e4Smrg>0x300</TT
1886fc018e4Smrg> and fills <TT
1896fc018e4SmrgCLASS="PARAMETER"
1906fc018e4Smrg><I
1916fc018e4Smrg>map</I
192a6844aabSmrg></TT
1936fc018e4Smrg> with
1946fc018e4Smrg<TABLE
1956fc018e4SmrgBORDER="0"
1966fc018e4SmrgBGCOLOR="#E0E0E0"
1976fc018e4SmrgWIDTH="100%"
1986fc018e4Smrg><TR
1996fc018e4Smrg><TD
2006fc018e4Smrg><PRE
2016fc018e4SmrgCLASS="LITERALLAYOUT"
2026fc018e4Smrg>0xffffffff 0xffffffff 0x01000008 0x44300002 0xffffd7f0 0xfffffffb 0xffff7fff 0xffff0003</PRE
2036fc018e4Smrg></TD
2046fc018e4Smrg></TR
2056fc018e4Smrg></TABLE
2066fc018e4Smrg>
2076fc018e4SmrgThen the page contains code points <TT
2086fc018e4SmrgCLASS="LITERAL"
2096fc018e4Smrg>0x300</TT
2106fc018e4Smrg> through
2116fc018e4Smrg<TT
2126fc018e4SmrgCLASS="LITERAL"
2136fc018e4Smrg>0x33f</TT
2146fc018e4Smrg> (the first 64 code points on the page)
2156fc018e4Smrgbecause <TT
2166fc018e4SmrgCLASS="PARAMETER"
2176fc018e4Smrg><I
2186fc018e4Smrg>map[0]</I
2196fc018e4Smrg></TT
2206fc018e4Smrg> and
2216fc018e4Smrg<TT
2226fc018e4SmrgCLASS="PARAMETER"
2236fc018e4Smrg><I
2246fc018e4Smrg>map[1]</I
2256fc018e4Smrg></TT
2266fc018e4Smrg> both have all their bits set.  It also
2276fc018e4Smrgcontains code points <TT
2286fc018e4SmrgCLASS="LITERAL"
2296fc018e4Smrg>0x343</TT
2306fc018e4Smrg> (<TT
2316fc018e4SmrgCLASS="PARAMETER"
2326fc018e4Smrg><I
2336fc018e4Smrg>0x300 + 32*2
2346fc018e4Smrg+ (4-1)</I
2356fc018e4Smrg></TT
2366fc018e4Smrg>) and <TT
2376fc018e4SmrgCLASS="LITERAL"
2386fc018e4Smrg>0x35e</TT
2396fc018e4Smrg> (<TT
2406fc018e4SmrgCLASS="PARAMETER"
2416fc018e4Smrg><I
2426fc018e4Smrg>0x300 +
2436fc018e4Smrg32*2 + (31-1)</I
2446fc018e4Smrg></TT
2456fc018e4Smrg>) because <TT
2466fc018e4SmrgCLASS="PARAMETER"
2476fc018e4Smrg><I
2486fc018e4Smrg>map[2]</I
2496fc018e4Smrg></TT
2506fc018e4Smrg> has
2516fc018e4Smrgthe 4th and 31st bits set.  The code points represented by
2526fc018e4Smrg<TT
2536fc018e4SmrgCLASS="LITERAL"
2546fc018e4Smrg>map[3]</TT
255a4e54154Smrg> and later are left as an exercise for the
2566fc018e4Smrgreader ;).
2571cc69409Smrg            </P
258a6844aabSmrg></DIV
259a6844aabSmrg><DIV
260a6844aabSmrgCLASS="NAVFOOTER"
261a6844aabSmrg><HR
262a6844aabSmrgALIGN="LEFT"
263a6844aabSmrgWIDTH="100%"><TABLE
264a6844aabSmrgSUMMARY="Footer navigation table"
265a6844aabSmrgWIDTH="100%"
266a6844aabSmrgBORDER="0"
267a6844aabSmrgCELLPADDING="0"
268a6844aabSmrgCELLSPACING="0"
269a6844aabSmrg><TR
270a6844aabSmrg><TD
271a6844aabSmrgWIDTH="33%"
272a6844aabSmrgALIGN="left"
273a6844aabSmrgVALIGN="top"
274a6844aabSmrg><A
275a6844aabSmrgHREF="fccharsetissubset.html"
276a6844aabSmrgACCESSKEY="P"
277a6844aabSmrg>&#60;&#60;&#60; Previous</A
278a6844aabSmrg></TD
279a6844aabSmrg><TD
280a6844aabSmrgWIDTH="34%"
281a6844aabSmrgALIGN="center"
282a6844aabSmrgVALIGN="top"
283a6844aabSmrg><A
284a6844aabSmrgHREF="t1.html"
285a6844aabSmrgACCESSKEY="H"
286a6844aabSmrg>Home</A
287a6844aabSmrg></TD
288a6844aabSmrg><TD
289a6844aabSmrgWIDTH="33%"
290a6844aabSmrgALIGN="right"
291a6844aabSmrgVALIGN="top"
292a6844aabSmrg><A
293a6844aabSmrgHREF="fccharsetnextpage.html"
294a6844aabSmrgACCESSKEY="N"
295a6844aabSmrg>Next &#62;&#62;&#62;</A
296a6844aabSmrg></TD
297a6844aabSmrg></TR
298a6844aabSmrg><TR
299a6844aabSmrg><TD
300a6844aabSmrgWIDTH="33%"
301a6844aabSmrgALIGN="left"
302a6844aabSmrgVALIGN="top"
303a6844aabSmrg>FcCharSetIsSubset</TD
304a6844aabSmrg><TD
305a6844aabSmrgWIDTH="34%"
306a6844aabSmrgALIGN="center"
307a6844aabSmrgVALIGN="top"
308a6844aabSmrg><A
309a32e9e42SmrgHREF="x103.html#AEN1869"
310a6844aabSmrgACCESSKEY="U"
311a6844aabSmrg>Up</A
312a6844aabSmrg></TD
313a6844aabSmrg><TD
314a6844aabSmrgWIDTH="33%"
315a6844aabSmrgALIGN="right"
316a6844aabSmrgVALIGN="top"
317a6844aabSmrg>FcCharSetNextPage</TD
318a6844aabSmrg></TR
319a6844aabSmrg></TABLE
320a6844aabSmrg></DIV
321a6844aabSmrg></BODY
322a6844aabSmrg></HTML
323a6844aabSmrg>