ac3ea388f6096b52db3b1e51c3d7fd6664434e27
[platform/upstream/fontconfig.git] / doc / fontconfig-devel / fcutf8len.html
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 >FcUtf8Len</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 HREF="t1.html"><LINK
11 REL="UP"
12 TITLE="String utilities"
13 HREF="x103.html#AEN4792"><LINK
14 REL="PREVIOUS"
15 TITLE="FcUcs4ToUtf8"
16 HREF="fcucs4toutf8.html"><LINK
17 REL="NEXT"
18 TITLE="FcUtf16ToUcs4"
19 HREF="fcutf16toucs4.html"></HEAD
20 ><BODY
21 CLASS="REFENTRY"
22 BGCOLOR="#FFFFFF"
23 TEXT="#000000"
24 LINK="#0000FF"
25 VLINK="#840084"
26 ALINK="#0000FF"
27 ><DIV
28 CLASS="NAVHEADER"
29 ><TABLE
30 SUMMARY="Header navigation table"
31 WIDTH="100%"
32 BORDER="0"
33 CELLPADDING="0"
34 CELLSPACING="0"
35 ><TR
36 ><TH
37 COLSPAN="3"
38 ALIGN="center"
39 ></TH
40 ></TR
41 ><TR
42 ><TD
43 WIDTH="10%"
44 ALIGN="left"
45 VALIGN="bottom"
46 ><A
47 HREF="fcucs4toutf8.html"
48 ACCESSKEY="P"
49 >&#60;&#60;&#60; Previous</A
50 ></TD
51 ><TD
52 WIDTH="80%"
53 ALIGN="center"
54 VALIGN="bottom"
55 ></TD
56 ><TD
57 WIDTH="10%"
58 ALIGN="right"
59 VALIGN="bottom"
60 ><A
61 HREF="fcutf16toucs4.html"
62 ACCESSKEY="N"
63 >Next &#62;&#62;&#62;</A
64 ></TD
65 ></TR
66 ></TABLE
67 ><HR
68 ALIGN="LEFT"
69 WIDTH="100%"></DIV
70 ><H1
71 ><A
72 NAME="FCUTF8LEN"
73 ></A
74 >FcUtf8Len</H1
75 ><DIV
76 CLASS="REFNAMEDIV"
77 ><A
78 NAME="AEN4850"
79 ></A
80 ><H2
81 >Name</H2
82 >FcUtf8Len&nbsp;--&nbsp;count UTF-8 encoded chars</DIV
83 ><DIV
84 CLASS="REFSYNOPSISDIV"
85 ><A
86 NAME="AEN4853"
87 ></A
88 ><H2
89 >Synopsis</H2
90 ><DIV
91 CLASS="FUNCSYNOPSIS"
92 ><P
93 ></P
94 ><A
95 NAME="AEN4854"
96 ></A
97 ><TABLE
98 BORDER="0"
99 BGCOLOR="#E0E0E0"
100 WIDTH="100%"
101 ><TR
102 ><TD
103 ><PRE
104 CLASS="FUNCSYNOPSISINFO"
105 >#include &#60;fontconfig/fontconfig.h&#62;
106         </PRE
107 ></TD
108 ></TR
109 ></TABLE
110 ><P
111 ><CODE
112 ><CODE
113 CLASS="FUNCDEF"
114 >FcBool <TT
115 CLASS="FUNCTION"
116 >FcUtf8Len</TT
117 ></CODE
118 >(FcChar8 *<TT
119 CLASS="PARAMETER"
120 ><I
121 >src</I
122 ></TT
123 >, int <TT
124 CLASS="PARAMETER"
125 ><I
126 >len</I
127 ></TT
128 >, int *<TT
129 CLASS="PARAMETER"
130 ><I
131 >nchar</I
132 ></TT
133 >, int *<TT
134 CLASS="PARAMETER"
135 ><I
136 >wchar</I
137 ></TT
138 >);</CODE
139 ></P
140 ><P
141 ></P
142 ></DIV
143 ></DIV
144 ><DIV
145 CLASS="REFSECT1"
146 ><A
147 NAME="AEN4867"
148 ></A
149 ><H2
150 >Description</H2
151 ><P
152 >Counts the number of Unicode chars in <TT
153 CLASS="PARAMETER"
154 ><I
155 >len</I
156 ></TT
157 > bytes of
158 <TT
159 CLASS="PARAMETER"
160 ><I
161 >src</I
162 ></TT
163 >.  Places that count in
164 <TT
165 CLASS="PARAMETER"
166 ><I
167 >nchar</I
168 ></TT
169 >.  <TT
170 CLASS="PARAMETER"
171 ><I
172 >wchar</I
173 ></TT
174 > contains 1, 2 or
175 4 depending on the number of bytes needed to hold the largest Unicode char
176 counted.  The return value indicates whether <TT
177 CLASS="PARAMETER"
178 ><I
179 >src</I
180 ></TT
181 > is a
182 well-formed UTF8 string.
183             </P
184 ></DIV
185 ><DIV
186 CLASS="NAVFOOTER"
187 ><HR
188 ALIGN="LEFT"
189 WIDTH="100%"><TABLE
190 SUMMARY="Footer navigation table"
191 WIDTH="100%"
192 BORDER="0"
193 CELLPADDING="0"
194 CELLSPACING="0"
195 ><TR
196 ><TD
197 WIDTH="33%"
198 ALIGN="left"
199 VALIGN="top"
200 ><A
201 HREF="fcucs4toutf8.html"
202 ACCESSKEY="P"
203 >&#60;&#60;&#60; Previous</A
204 ></TD
205 ><TD
206 WIDTH="34%"
207 ALIGN="center"
208 VALIGN="top"
209 ><A
210 HREF="t1.html"
211 ACCESSKEY="H"
212 >Home</A
213 ></TD
214 ><TD
215 WIDTH="33%"
216 ALIGN="right"
217 VALIGN="top"
218 ><A
219 HREF="fcutf16toucs4.html"
220 ACCESSKEY="N"
221 >Next &#62;&#62;&#62;</A
222 ></TD
223 ></TR
224 ><TR
225 ><TD
226 WIDTH="33%"
227 ALIGN="left"
228 VALIGN="top"
229 >FcUcs4ToUtf8</TD
230 ><TD
231 WIDTH="34%"
232 ALIGN="center"
233 VALIGN="top"
234 ><A
235 HREF="x103.html#AEN4792"
236 ACCESSKEY="U"
237 >Up</A
238 ></TD
239 ><TD
240 WIDTH="33%"
241 ALIGN="right"
242 VALIGN="top"
243 >FcUtf16ToUcs4</TD
244 ></TR
245 ></TABLE
246 ></DIV
247 ></BODY
248 ></HTML
249 >