Imported Upstream version 2.13.0
[platform/upstream/fontconfig.git] / doc / fontconfig-devel / fcutf16len.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 >FcUtf16Len</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="FcUtf16ToUcs4"
16 HREF="fcutf16toucs4.html"><LINK
17 REL="NEXT"
18 TITLE="FcIsLower"
19 HREF="fcislower.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="fcutf16toucs4.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="fcislower.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="FCUTF16LEN"
73 ></A
74 >FcUtf16Len</H1
75 ><DIV
76 CLASS="REFNAMEDIV"
77 ><A
78 NAME="AEN4911"
79 ></A
80 ><H2
81 >Name</H2
82 >FcUtf16Len&nbsp;--&nbsp;count UTF-16 encoded chars</DIV
83 ><DIV
84 CLASS="REFSYNOPSISDIV"
85 ><A
86 NAME="AEN4914"
87 ></A
88 ><H2
89 >Synopsis</H2
90 ><DIV
91 CLASS="FUNCSYNOPSIS"
92 ><P
93 ></P
94 ><A
95 NAME="AEN4915"
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 >FcUtf16Len</TT
117 ></CODE
118 >(FcChar8 *<TT
119 CLASS="PARAMETER"
120 ><I
121 >src</I
122 ></TT
123 >, FcEndian <TT
124 CLASS="PARAMETER"
125 ><I
126 >endian</I
127 ></TT
128 >, int <TT
129 CLASS="PARAMETER"
130 ><I
131 >len</I
132 ></TT
133 >, int *<TT
134 CLASS="PARAMETER"
135 ><I
136 >nchar</I
137 ></TT
138 >, int *<TT
139 CLASS="PARAMETER"
140 ><I
141 >wchar</I
142 ></TT
143 >);</CODE
144 ></P
145 ><P
146 ></P
147 ></DIV
148 ></DIV
149 ><DIV
150 CLASS="REFSECT1"
151 ><A
152 NAME="AEN4930"
153 ></A
154 ><H2
155 >Description</H2
156 ><P
157 >Counts the number of Unicode chars in <TT
158 CLASS="PARAMETER"
159 ><I
160 >len</I
161 ></TT
162 > bytes of
163 <TT
164 CLASS="PARAMETER"
165 ><I
166 >src</I
167 ></TT
168 >.  Bytes of <TT
169 CLASS="PARAMETER"
170 ><I
171 >src</I
172 ></TT
173 > are
174 combined into 16-bit units according to <TT
175 CLASS="PARAMETER"
176 ><I
177 >endian</I
178 ></TT
179 >.
180 Places that count in <TT
181 CLASS="PARAMETER"
182 ><I
183 >nchar</I
184 ></TT
185 >.
186 <TT
187 CLASS="PARAMETER"
188 ><I
189 >wchar</I
190 ></TT
191 > contains 1, 2 or 4 depending on the number of
192 bytes needed to hold the largest Unicode char counted.  The return value
193 indicates whether <TT
194 CLASS="PARAMETER"
195 ><I
196 >string</I
197 ></TT
198 > is a well-formed UTF16
199 string.
200             </P
201 ></DIV
202 ><DIV
203 CLASS="NAVFOOTER"
204 ><HR
205 ALIGN="LEFT"
206 WIDTH="100%"><TABLE
207 SUMMARY="Footer navigation table"
208 WIDTH="100%"
209 BORDER="0"
210 CELLPADDING="0"
211 CELLSPACING="0"
212 ><TR
213 ><TD
214 WIDTH="33%"
215 ALIGN="left"
216 VALIGN="top"
217 ><A
218 HREF="fcutf16toucs4.html"
219 ACCESSKEY="P"
220 >&#60;&#60;&#60; Previous</A
221 ></TD
222 ><TD
223 WIDTH="34%"
224 ALIGN="center"
225 VALIGN="top"
226 ><A
227 HREF="t1.html"
228 ACCESSKEY="H"
229 >Home</A
230 ></TD
231 ><TD
232 WIDTH="33%"
233 ALIGN="right"
234 VALIGN="top"
235 ><A
236 HREF="fcislower.html"
237 ACCESSKEY="N"
238 >Next &#62;&#62;&#62;</A
239 ></TD
240 ></TR
241 ><TR
242 ><TD
243 WIDTH="33%"
244 ALIGN="left"
245 VALIGN="top"
246 >FcUtf16ToUcs4</TD
247 ><TD
248 WIDTH="34%"
249 ALIGN="center"
250 VALIGN="top"
251 ><A
252 HREF="x103.html#AEN4792"
253 ACCESSKEY="U"
254 >Up</A
255 ></TD
256 ><TD
257 WIDTH="33%"
258 ALIGN="right"
259 VALIGN="top"
260 >FcIsLower</TD
261 ></TR
262 ></TABLE
263 ></DIV
264 ></BODY
265 ></HTML
266 >