fcutf16len.html revision b09479dc
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 7NAME="GENERATOR" 8CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9REL="HOME" 10HREF="t1.html"><LINK 11REL="UP" 12TITLE="String utilities" 13HREF="x102.html#AEN4336"><LINK 14REL="PREVIOUS" 15TITLE="FcUtf16ToUcs4" 16HREF="fcutf16toucs4.html"><LINK 17REL="NEXT" 18TITLE="FcIsLower" 19HREF="fcislower.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="fcutf16toucs4.html" 48ACCESSKEY="P" 49><<< 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="fcislower.html" 62ACCESSKEY="N" 63>Next >>></A 64></TD 65></TR 66></TABLE 67><HR 68ALIGN="LEFT" 69WIDTH="100%"></DIV 70><H1 71><A 72NAME="FCUTF16LEN" 73></A 74>FcUtf16Len</H1 75><DIV 76CLASS="REFNAMEDIV" 77><A 78NAME="AEN4455" 79></A 80><H2 81>Name</H2 82>FcUtf16Len -- count UTF-16 encoded chars</DIV 83><DIV 84CLASS="REFSYNOPSISDIV" 85><A 86NAME="AEN4458" 87></A 88><H2 89>Synopsis</H2 90><DIV 91CLASS="FUNCSYNOPSIS" 92><P 93></P 94><A 95NAME="AEN4459" 96></A 97><TABLE 98BORDER="0" 99BGCOLOR="#E0E0E0" 100WIDTH="100%" 101><TR 102><TD 103><PRE 104CLASS="FUNCSYNOPSISINFO" 105>#include <fontconfig/fontconfig.h> 106 </PRE 107></TD 108></TR 109></TABLE 110><P 111><CODE 112><CODE 113CLASS="FUNCDEF" 114>FcBool <TT 115CLASS="FUNCTION" 116>FcUtf16Len</TT 117></CODE 118>(FcChar8 *<TT 119CLASS="PARAMETER" 120><I 121>src</I 122></TT 123>, FcEndian <TT 124CLASS="PARAMETER" 125><I 126>endian</I 127></TT 128>, int <TT 129CLASS="PARAMETER" 130><I 131>len</I 132></TT 133>, int *<TT 134CLASS="PARAMETER" 135><I 136>nchar</I 137></TT 138>, int *<TT 139CLASS="PARAMETER" 140><I 141>wchar</I 142></TT 143>);</CODE 144></P 145><P 146></P 147></DIV 148></DIV 149><DIV 150CLASS="REFSECT1" 151><A 152NAME="AEN4474" 153></A 154><H2 155>Description</H2 156><P 157>Counts the number of Unicode chars in <TT 158CLASS="PARAMETER" 159><I 160>len</I 161></TT 162> bytes of 163<TT 164CLASS="PARAMETER" 165><I 166>src</I 167></TT 168>. Bytes of <TT 169CLASS="PARAMETER" 170><I 171>src</I 172></TT 173> are 174combined into 16-bit units according to <TT 175CLASS="PARAMETER" 176><I 177>endian</I 178></TT 179>. 180Places that count in <TT 181CLASS="PARAMETER" 182><I 183>nchar</I 184></TT 185>. 186<TT 187CLASS="PARAMETER" 188><I 189>wchar</I 190></TT 191> contains 1, 2 or 4 depending on the number of 192bytes needed to hold the largest Unicode char counted. The return value 193indicates whether <TT 194CLASS="PARAMETER" 195><I 196>string</I 197></TT 198> is a well-formed UTF16 199string. 200 </P 201></DIV 202><DIV 203CLASS="NAVFOOTER" 204><HR 205ALIGN="LEFT" 206WIDTH="100%"><TABLE 207SUMMARY="Footer navigation table" 208WIDTH="100%" 209BORDER="0" 210CELLPADDING="0" 211CELLSPACING="0" 212><TR 213><TD 214WIDTH="33%" 215ALIGN="left" 216VALIGN="top" 217><A 218HREF="fcutf16toucs4.html" 219ACCESSKEY="P" 220><<< Previous</A 221></TD 222><TD 223WIDTH="34%" 224ALIGN="center" 225VALIGN="top" 226><A 227HREF="t1.html" 228ACCESSKEY="H" 229>Home</A 230></TD 231><TD 232WIDTH="33%" 233ALIGN="right" 234VALIGN="top" 235><A 236HREF="fcislower.html" 237ACCESSKEY="N" 238>Next >>></A 239></TD 240></TR 241><TR 242><TD 243WIDTH="33%" 244ALIGN="left" 245VALIGN="top" 246>FcUtf16ToUcs4</TD 247><TD 248WIDTH="34%" 249ALIGN="center" 250VALIGN="top" 251><A 252HREF="x102.html#AEN4336" 253ACCESSKEY="U" 254>Up</A 255></TD 256><TD 257WIDTH="33%" 258ALIGN="right" 259VALIGN="top" 260>FcIsLower</TD 261></TR 262></TABLE 263></DIV 264></BODY 265></HTML 266>