source: trunk/doc/html/qchar.html

Last change on this file was 190, checked in by rudi, 14 years ago

reference documentation added
File size: 29.7 KB
RevLine 
[190]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/tools/qstring.cpp:166 -->
3<html>
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6<title>QChar Class</title>
7<style type="text/css"><!--
8fn { margin-left: 1cm; text-indent: -1cm; }
9a:link { color: #004faf; text-decoration: none }
10a:visited { color: #672967; text-decoration: none }
11body { background: #ffffff; color: black; }
12--></style>
13</head>
14<body>
15
16<table border="0" cellpadding="0" cellspacing="0" width="100%">
17<tr bgcolor="#E5E5E5">
18<td valign=center>
19 <a href="index.html">
20<font color="#004faf">Home</font></a>
21 | <a href="classes.html">
22<font color="#004faf">All&nbsp;Classes</font></a>
23 | <a href="mainclasses.html">
24<font color="#004faf">Main&nbsp;Classes</font></a>
25 | <a href="annotated.html">
26<font color="#004faf">Annotated</font></a>
27 | <a href="groups.html">
28<font color="#004faf">Grouped&nbsp;Classes</font></a>
29 | <a href="functions.html">
30<font color="#004faf">Functions</font></a>
31</td>
32<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QChar Class Reference</h1>
33
34<p>The QChar class provides a lightweight Unicode character.
35<a href="#details">More...</a>
36<p>Almost all the functions in this class are <a href="threads.html#reentrant">reentrant</a> when Qt is built with thread support. The exception is <a href="#decomposition"><b>decomposition</b></a>().
37</p><p><tt>#include &lt;<a href="qstring-h.html">qstring.h</a>&gt;</tt>
38<p><a href="qchar-members.html">List of all member functions.</a>
39<h2>Public Members</h2>
40<ul>
41<li class=fn><a href="#QChar"><b>QChar</b></a> ()</li>
42<li class=fn><a href="#QChar-2"><b>QChar</b></a> ( char&nbsp;c )</li>
43<li class=fn><a href="#QChar-3"><b>QChar</b></a> ( uchar&nbsp;c )</li>
44<li class=fn><a href="#QChar-4"><b>QChar</b></a> ( uchar&nbsp;c, uchar&nbsp;r )</li>
45<li class=fn><a href="#QChar-5"><b>QChar</b></a> ( const&nbsp;QChar&nbsp;&amp;&nbsp;c )</li>
46<li class=fn><a href="#QChar-6"><b>QChar</b></a> ( ushort&nbsp;rc )</li>
47<li class=fn><a href="#QChar-7"><b>QChar</b></a> ( short&nbsp;rc )</li>
48<li class=fn><a href="#QChar-8"><b>QChar</b></a> ( uint&nbsp;rc )</li>
49<li class=fn><a href="#QChar-9"><b>QChar</b></a> ( int&nbsp;rc )</li>
50<li class=fn>enum <a href="#Category-enum"><b>Category</b></a> { NoCategory, Mark_NonSpacing, Mark_SpacingCombining, Mark_Enclosing, Number_DecimalDigit, Number_Letter, Number_Other, Separator_Space, Separator_Line, Separator_Paragraph, Other_Control, Other_Format, Other_Surrogate, Other_PrivateUse, Other_NotAssigned, Letter_Uppercase, Letter_Lowercase, Letter_Titlecase, Letter_Modifier, Letter_Other, Punctuation_Connector, Punctuation_Dash, Punctuation_Dask = Punctuation_Dash, Punctuation_Open, Punctuation_Close, Punctuation_InitialQuote, Punctuation_FinalQuote, Punctuation_Other, Symbol_Math, Symbol_Currency, Symbol_Modifier, Symbol_Other }</li>
51<li class=fn>enum <a href="#Direction-enum"><b>Direction</b></a> { DirL, DirR, DirEN, DirES, DirET, DirAN, DirCS, DirB, DirS, DirWS, DirON, DirLRE, DirLRO, DirAL, DirRLE, DirRLO, DirPDF, DirNSM, DirBN }</li>
52<li class=fn>enum <a href="#Decomposition-enum"><b>Decomposition</b></a> { Single, Canonical, Font, NoBreak, Initial, Medial, Final, Isolated, Circle, Super, Sub, Vertical, Wide, Narrow, Small, Square, Compat, Fraction }</li>
53<li class=fn>enum <a href="#Joining-enum"><b>Joining</b></a> { OtherJoining, Dual, Right, Center }</li>
54<li class=fn>enum <a href="#CombiningClass-enum"><b>CombiningClass</b></a> { Combining_BelowLeftAttached = 200, Combining_BelowAttached = 202, Combining_BelowRightAttached = 204, Combining_LeftAttached = 208, Combining_RightAttached = 210, Combining_AboveLeftAttached = 212, Combining_AboveAttached = 214, Combining_AboveRightAttached = 216, Combining_BelowLeft = 218, Combining_Below = 220, Combining_BelowRight = 222, Combining_Left = 224, Combining_Right = 226, Combining_AboveLeft = 228, Combining_Above = 230, Combining_AboveRight = 232, Combining_DoubleBelow = 233, Combining_DoubleAbove = 234, Combining_IotaSubscript = 240 }</li>
55<li class=fn>int <a href="#digitValue"><b>digitValue</b></a> () const</li>
56<li class=fn>QChar <a href="#lower"><b>lower</b></a> () const</li>
57<li class=fn>QChar <a href="#upper"><b>upper</b></a> () const</li>
58<li class=fn>Category <a href="#category"><b>category</b></a> () const</li>
59<li class=fn>Direction <a href="#direction"><b>direction</b></a> () const</li>
60<li class=fn>Joining <a href="#joining"><b>joining</b></a> () const</li>
61<li class=fn>bool <a href="#mirrored"><b>mirrored</b></a> () const</li>
62<li class=fn>QChar <a href="#mirroredChar"><b>mirroredChar</b></a> () const</li>
63<li class=fn>const QString &amp; <a href="#decomposition"><b>decomposition</b></a> () const</li>
64<li class=fn>Decomposition <a href="#decompositionTag"><b>decompositionTag</b></a> () const</li>
65<li class=fn>unsigned char <a href="#combiningClass"><b>combiningClass</b></a> () const</li>
66<li class=fn>char <a href="#latin1"><b>latin1</b></a> () const</li>
67<li class=fn>ushort <a href="#unicode"><b>unicode</b></a> () const</li>
68<li class=fn>ushort &amp; <a href="#unicode-2"><b>unicode</b></a> ()</li>
69<li class=fn><a href="#operator-char"><b>operator char</b></a> () const</li>
70<li class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</li>
71<li class=fn>bool <a href="#isPrint"><b>isPrint</b></a> () const</li>
72<li class=fn>bool <a href="#isPunct"><b>isPunct</b></a> () const</li>
73<li class=fn>bool <a href="#isSpace"><b>isSpace</b></a> () const</li>
74<li class=fn>bool <a href="#isMark"><b>isMark</b></a> () const</li>
75<li class=fn>bool <a href="#isLetter"><b>isLetter</b></a> () const</li>
76<li class=fn>bool <a href="#isNumber"><b>isNumber</b></a> () const</li>
77<li class=fn>bool <a href="#isLetterOrNumber"><b>isLetterOrNumber</b></a> () const</li>
78<li class=fn>bool <a href="#isDigit"><b>isDigit</b></a> () const</li>
79<li class=fn>bool <a href="#isSymbol"><b>isSymbol</b></a> () const</li>
80<li class=fn>uchar <a href="#cell"><b>cell</b></a> () const</li>
81<li class=fn>uchar <a href="#row"><b>row</b></a> () const</li>
82</ul>
83<h2>Static Public Members</h2>
84<ul>
85<li class=fn>bool networkOrdered () &nbsp;<em>(obsolete)</em></li>
86</ul>
87<h2>Related Functions</h2>
88<ul>
89<li class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( QChar&nbsp;c1, QChar&nbsp;c2 )</li>
90<li class=fn>bool <a href="#operator-eq-eq-2"><b>operator==</b></a> ( char&nbsp;ch, QChar&nbsp;c )</li>
91<li class=fn>bool <a href="#operator-eq-eq-3"><b>operator==</b></a> ( QChar&nbsp;c, char&nbsp;ch )</li>
92<li class=fn>int <a href="#operator!-eq"><b>operator!=</b></a> ( QChar&nbsp;c1, QChar&nbsp;c2 )</li>
93<li class=fn>int <a href="#operator!-eq-2"><b>operator!=</b></a> ( char&nbsp;ch, QChar&nbsp;c )</li>
94<li class=fn>int <a href="#operator!-eq-3"><b>operator!=</b></a> ( QChar&nbsp;c, char&nbsp;ch )</li>
95<li class=fn>int <a href="#operator-lt-eq"><b>operator&lt;=</b></a> ( QChar&nbsp;c1, QChar&nbsp;c2 )</li>
96<li class=fn>int <a href="#operator-lt-eq-2"><b>operator&lt;=</b></a> ( QChar&nbsp;c, char&nbsp;ch )</li>
97<li class=fn>int <a href="#operator-lt-eq-3"><b>operator&lt;=</b></a> ( char&nbsp;ch, QChar&nbsp;c )</li>
98<li class=fn>int <a href="#operator-gt-eq"><b>operator&gt;=</b></a> ( QChar&nbsp;c1, QChar&nbsp;c2 )</li>
99<li class=fn>int <a href="#operator-gt-eq-2"><b>operator&gt;=</b></a> ( QChar&nbsp;c, char&nbsp;ch )</li>
100<li class=fn>int <a href="#operator-gt-eq-3"><b>operator&gt;=</b></a> ( char&nbsp;ch, QChar&nbsp;c )</li>
101<li class=fn>int <a href="#operator-lt"><b>operator&lt;</b></a> ( QChar&nbsp;c1, QChar&nbsp;c2 )</li>
102<li class=fn>int <a href="#operator-lt-2"><b>operator&lt;</b></a> ( QChar&nbsp;c, char&nbsp;ch )</li>
103<li class=fn>int <a href="#operator-lt-3"><b>operator&lt;</b></a> ( char&nbsp;ch, QChar&nbsp;c )</li>
104<li class=fn>int <a href="#operator-gt"><b>operator&gt;</b></a> ( QChar&nbsp;c1, QChar&nbsp;c2 )</li>
105<li class=fn>int <a href="#operator-gt-2"><b>operator&gt;</b></a> ( QChar&nbsp;c, char&nbsp;ch )</li>
106<li class=fn>int <a href="#operator-gt-3"><b>operator&gt;</b></a> ( char&nbsp;ch, QChar&nbsp;c )</li>
107</ul>
108<hr><a name="details"></a><h2>Detailed Description</h2>
109
110
111
112The QChar class provides a lightweight Unicode character.
113<p>
114<p> Unicode characters are (so far) 16-bit entities without any markup
115or structure. This class represents such an entity. It is
116lightweight, so it can be used everywhere. Most compilers treat it
117like a "short int". (In a few years it may be necessary to make
118QChar 32-bit when more than 65536 Unicode code points have been
119defined and come into use.)
120<p> QChar provides a full complement of testing/classification
121functions, converting to and from other formats, converting from
122composed to decomposed Unicode, and trying to compare and
123case-convert if you ask it to.
124<p> The classification functions include functions like those in
125ctype.h, but operating on the full range of Unicode characters.
126They all return TRUE if the character is a certain type of
127character; otherwise they return FALSE. These classification
128functions are <a href="#isNull">isNull</a>() (returns TRUE if the character is U+0000),
129<a href="#isPrint">isPrint</a>() (TRUE if the character is any sort of printable
130character, including whitespace), <a href="#isPunct">isPunct</a>() (any sort of
131punctation), <a href="#isMark">isMark</a>() (Unicode Mark), isLetter (a letter),
132<a href="#isNumber">isNumber</a>() (any sort of numeric character), <a href="#isLetterOrNumber">isLetterOrNumber</a>(),
133and <a href="#isDigit">isDigit</a>() (decimal digits). All of these are wrappers around
134<a href="#category">category</a>() which return the Unicode-defined category of each
135character.
136<p> QChar further provides <a href="#direction">direction</a>(), which indicates the "natural"
137writing direction of this character. The <a href="#joining">joining</a>() function
138indicates how the character joins with its neighbors (needed
139mostly for Arabic) and finally <a href="#mirrored">mirrored</a>(), which indicates whether
140the character needs to be mirrored when it is printed in its
141"unnatural" writing direction.
142<p> Composed Unicode characters (like &aring;) can be converted to
143decomposed Unicode ("a" followed by "ring above") by using
144<a href="#decomposition">decomposition</a>().
145<p> In Unicode, comparison is not necessarily possible and case
146conversion is very difficult at best. Unicode, covering the
147"entire" world, also includes most of the world's case and sorting
148problems. Qt tries, but not very hard: <a href="#operator-eq-eq">operator==</a>() and friends
149will do comparison based purely on the numeric Unicode value (code
150point) of the characters, and <a href="#upper">upper</a>() and <a href="#lower">lower</a>() will do case
151changes when the character has a well-defined upper/lower-case
152equivalent. There is no provision for locale-dependent case
153folding rules or comparison; these functions are meant to be fast
154so they can be used unambiguously in data structures. (See
155<a href="qstring.html#localeAwareCompare">QString::localeAwareCompare</a>() though.)
156<p> The conversion functions include <a href="#unicode">unicode</a>() (to a scalar), <a href="#latin1">latin1</a>()
157(to scalar, but converts all non-Latin-1 characters to 0), <a href="#row">row</a>()
158(gives the Unicode row), <a href="#cell">cell</a>() (gives the Unicode cell),
159<a href="#digitValue">digitValue</a>() (gives the integer value of any of the numerous digit
160characters), and a host of constructors.
161<p> More information can be found in the document <a href="unicode.html">About Unicode.</a>
162<p> <p>See also <a href="qstring.html">QString</a>, <a href="qcharref.html">QCharRef</a>, and <a href="text.html">Text Related Classes</a>.
163
164<hr><h2>Member Type Documentation</h2>
165<h3 class=fn><a name="Category-enum"></a>QChar::Category</h3>
166
167<p> This enum maps the Unicode character categories.
168<p> The following characters are normative in Unicode:
169<ul>
170<li><tt>QChar::Mark_NonSpacing</tt> - Unicode class name Mn
171<li><tt>QChar::Mark_SpacingCombining</tt> - Unicode class name Mc
172<li><tt>QChar::Mark_Enclosing</tt> - Unicode class name Me
173<li><tt>QChar::Number_DecimalDigit</tt> - Unicode class name Nd
174<li><tt>QChar::Number_Letter</tt> - Unicode class name Nl
175<li><tt>QChar::Number_Other</tt> - Unicode class name No
176<li><tt>QChar::Separator_Space</tt> - Unicode class name Zs
177<li><tt>QChar::Separator_Line</tt> - Unicode class name Zl
178<li><tt>QChar::Separator_Paragraph</tt> - Unicode class name Zp
179<li><tt>QChar::Other_Control</tt> - Unicode class name Cc
180<li><tt>QChar::Other_Format</tt> - Unicode class name Cf
181<li><tt>QChar::Other_Surrogate</tt> - Unicode class name Cs
182<li><tt>QChar::Other_PrivateUse</tt> - Unicode class name Co
183<li><tt>QChar::Other_NotAssigned</tt> - Unicode class name Cn
184</ul><p> The following categories are informative in Unicode:
185<ul>
186<li><tt>QChar::Letter_Uppercase</tt> - Unicode class name Lu
187<li><tt>QChar::Letter_Lowercase</tt> - Unicode class name Ll
188<li><tt>QChar::Letter_Titlecase</tt> - Unicode class name Lt
189<li><tt>QChar::Letter_Modifier</tt> - Unicode class name Lm
190<li><tt>QChar::Letter_Other</tt> - Unicode class name Lo
191<li><tt>QChar::Punctuation_Connector</tt> - Unicode class name Pc
192<li><tt>QChar::Punctuation_Dash</tt> - Unicode class name Pd
193<li><tt>QChar::Punctuation_Open</tt> - Unicode class name Ps
194<li><tt>QChar::Punctuation_Close</tt> - Unicode class name Pe
195<li><tt>QChar::Punctuation_InitialQuote</tt> - Unicode class name Pi
196<li><tt>QChar::Punctuation_FinalQuote</tt> - Unicode class name Pf
197<li><tt>QChar::Punctuation_Other</tt> - Unicode class name Po
198<li><tt>QChar::Symbol_Math</tt> - Unicode class name Sm
199<li><tt>QChar::Symbol_Currency</tt> - Unicode class name Sc
200<li><tt>QChar::Symbol_Modifier</tt> - Unicode class name Sk
201<li><tt>QChar::Symbol_Other</tt> - Unicode class name So
202</ul><p> There are two categories that are specific to Qt:
203<ul>
204<li><tt>QChar::NoCategory</tt> - used when Qt is dazed and confused and cannot
205make sense of anything.
206<li><tt>QChar::Punctuation_Dask</tt> - old typo alias for Punctuation_Dash
207</ul><p>
208<h3 class=fn><a name="CombiningClass-enum"></a>QChar::CombiningClass</h3>
209
210<p> This enum type defines names for some of the Unicode combining
211classes. See <a href="http://www.unicode.org/">the Unicode
212 Standard</a> for a description of the values.
213
214<h3 class=fn><a name="Decomposition-enum"></a>QChar::Decomposition</h3>
215
216<p> This enum type defines the Unicode decomposition attributes. See
217<a href="http://www.unicode.org/">the Unicode Standard</a> for a
218description of the values.
219
220<h3 class=fn><a name="Direction-enum"></a>QChar::Direction</h3>
221
222<p> This enum type defines the Unicode direction attributes. See <a href="http://www.unicode.org/">the Unicode Standard</a> for a
223description of the values.
224<p> In order to conform to C/C++ naming conventions "Dir" is prepended
225to the codes used in the Unicode Standard.
226
227<h3 class=fn><a name="Joining-enum"></a>QChar::Joining</h3>
228
229<p> This enum type defines the Unicode joining attributes. See <a href="http://www.unicode.org/">the Unicode Standard</a> for a
230description of the values.
231
232<hr><h2>Member Function Documentation</h2>
233<h3 class=fn><a name="QChar"></a>QChar::QChar ()
234</h3>
235
236<p> Constructs a null QChar (one that <a href="#isNull">isNull</a>()).
237
238<h3 class=fn><a name="QChar-2"></a>QChar::QChar ( char&nbsp;c )
239</h3>
240
241<p> Constructs a QChar corresponding to ASCII/Latin-1 character <em>c</em>.
242
243<h3 class=fn><a name="QChar-3"></a>QChar::QChar ( uchar&nbsp;c )
244</h3>
245
246<p> Constructs a QChar corresponding to ASCII/Latin-1 character <em>c</em>.
247
248<h3 class=fn><a name="QChar-4"></a>QChar::QChar ( uchar&nbsp;c, uchar&nbsp;r )
249</h3>
250
251<p> Constructs a QChar for Unicode cell <em>c</em> in row <em>r</em>.
252
253<h3 class=fn><a name="QChar-5"></a>QChar::QChar ( const&nbsp;<a href="qchar.html">QChar</a>&nbsp;&amp;&nbsp;c )
254</h3>
255
256<p> Constructs a copy of <em>c</em>. This is a <a href="shclass.html#deep-copy">deep copy</a>, if such a
257lightweight object can be said to have deep copies.
258
259<h3 class=fn><a name="QChar-6"></a>QChar::QChar ( ushort&nbsp;rc )
260</h3>
261
262<p> Constructs a QChar for the character with Unicode code point <em>rc</em>.
263
264<h3 class=fn><a name="QChar-7"></a>QChar::QChar ( short&nbsp;rc )
265</h3>
266
267<p> Constructs a QChar for the character with Unicode code point <em>rc</em>.
268
269<h3 class=fn><a name="QChar-8"></a>QChar::QChar ( uint&nbsp;rc )
270</h3>
271
272<p> Constructs a QChar for the character with Unicode code point <em>rc</em>.
273
274<h3 class=fn><a name="QChar-9"></a>QChar::QChar ( int&nbsp;rc )
275</h3>
276
277<p> Constructs a QChar for the character with Unicode code point <em>rc</em>.
278
279<h3 class=fn><a href="qchar.html#Category-enum">Category</a> <a name="category"></a>QChar::category () const
280</h3>
281Returns the character category.
282<p> <p>See also <a href="#Category-enum">Category</a>.
283
284<h3 class=fn>uchar <a name="cell"></a>QChar::cell () const
285</h3>
286
287<p> Returns the cell (least significant byte) of the Unicode
288character.
289
290<h3 class=fn>unsigned char <a name="combiningClass"></a>QChar::combiningClass () const
291</h3>
292Returns the combining class for the character as defined in the
293Unicode standard. This is mainly useful as a positioning hint for
294marks attached to a base character.
295<p> The Qt text rendering engine uses this information to correctly
296position non spacing marks around a base character.
297
298<h3 class=fn>const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp; <a name="decomposition"></a>QChar::decomposition () const
299</h3><p><b>Warning:</b> This function is <i>not</i> <a href="threads.html#reentrant">reentrant</a>.</p>
300
301
302<p> Decomposes a character into its parts. Returns <a href="qstring.html#QString-null">QString::null</a> if no
303decomposition exists.
304
305<h3 class=fn><a href="qchar.html#Decomposition-enum">Decomposition</a> <a name="decompositionTag"></a>QChar::decompositionTag () const
306</h3>
307Returns the tag defining the composition of the character. Returns
308QChar::Single if no decomposition exists.
309
310<h3 class=fn>int <a name="digitValue"></a>QChar::digitValue () const
311</h3>
312Returns the numeric value of the digit, or -1 if the character is
313not a digit.
314
315<h3 class=fn><a href="qchar.html#Direction-enum">Direction</a> <a name="direction"></a>QChar::direction () const
316</h3>
317Returns the character's direction.
318<p> <p>See also <a href="#Direction-enum">Direction</a>.
319
320<h3 class=fn>bool <a name="isDigit"></a>QChar::isDigit () const
321</h3>
322Returns TRUE if the character is a decimal digit
323(Number_DecimalDigit); otherwise returns FALSE.
324
325<h3 class=fn>bool <a name="isLetter"></a>QChar::isLetter () const
326</h3>
327Returns TRUE if the character is a letter (Letter_* categories);
328otherwise returns FALSE.
329
330<h3 class=fn>bool <a name="isLetterOrNumber"></a>QChar::isLetterOrNumber () const
331</h3>
332Returns TRUE if the character is a letter or number (Letter_* or
333Number_* categories); otherwise returns FALSE.
334
335<h3 class=fn>bool <a name="isMark"></a>QChar::isMark () const
336</h3>
337Returns TRUE if the character is a mark (Mark_* categories);
338otherwise returns FALSE.
339
340<h3 class=fn>bool <a name="isNull"></a>QChar::isNull () const
341</h3>
342
343<p> Returns TRUE if the character is the Unicode character 0x0000
344(ASCII NUL); otherwise returns FALSE.
345
346<h3 class=fn>bool <a name="isNumber"></a>QChar::isNumber () const
347</h3>
348Returns TRUE if the character is a number (of any sort - Number_*
349categories); otherwise returns FALSE.
350<p> <p>See also <a href="#isDigit">isDigit</a>().
351
352<h3 class=fn>bool <a name="isPrint"></a>QChar::isPrint () const
353</h3>
354Returns TRUE if the character is a printable character; otherwise
355returns FALSE. This is any character not of category Cc or Cn.
356<p> Note that this gives no indication of whether the character is
357available in a particular <a href="qfont.html">font</a>.
358
359<h3 class=fn>bool <a name="isPunct"></a>QChar::isPunct () const
360</h3>
361Returns TRUE if the character is a punctuation mark (Punctuation_*
362categories); otherwise returns FALSE.
363
364<h3 class=fn>bool <a name="isSpace"></a>QChar::isSpace () const
365</h3>
366Returns TRUE if the character is a separator character
367(Separator_* categories); otherwise returns FALSE.
368
369<h3 class=fn>bool <a name="isSymbol"></a>QChar::isSymbol () const
370</h3>
371Returns TRUE if the character is a symbol (Symbol_* categories);
372otherwise returns FALSE.
373
374<h3 class=fn><a href="qchar.html#Joining-enum">Joining</a> <a name="joining"></a>QChar::joining () const
375</h3>
376<b>Warning:</b> This function is not supported (it may change to use
377Unicode character classes).
378<p> Returns information about the joining properties of the character
379(needed for example, for Arabic).
380
381<h3 class=fn>char <a name="latin1"></a>QChar::latin1 () const
382</h3>
383
384<p> Returns the Latin-1 value of this character, or 0 if it
385cannot be represented in Latin-1.
386
387<h3 class=fn><a href="qchar.html">QChar</a> <a name="lower"></a>QChar::lower () const
388</h3>
389Returns the lowercase equivalent if the character is uppercase;
390otherwise returns the character itself.
391
392<h3 class=fn>bool <a name="mirrored"></a>QChar::mirrored () const
393</h3>
394Returns TRUE if the character is a mirrored character (one that
395should be reversed if the text direction is reversed); otherwise
396returns FALSE.
397
398<h3 class=fn><a href="qchar.html">QChar</a> <a name="mirroredChar"></a>QChar::mirroredChar () const
399</h3>
400Returns the mirrored character if this character is a mirrored
401character, otherwise returns the character itself.
402
403<h3 class=fn>bool <a name="networkOrdered"></a>QChar::networkOrdered ()<tt> [static]</tt>
404</h3>
405
406<p> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
407<p> Returns TRUE if this character is in network byte order (MSB
408first); otherwise returns FALSE. This is platform dependent.
409
410<h3 class=fn><a name="operator-char"></a>QChar::operator char () const
411</h3>
412
413<p> Returns the Latin-1 character equivalent to the QChar, or 0. This
414is mainly useful for non-internationalized software.
415<p> <p>See also <a href="#unicode">unicode</a>().
416
417<h3 class=fn>uchar <a name="row"></a>QChar::row () const
418</h3>
419
420<p> Returns the row (most significant byte) of the Unicode character.
421
422<h3 class=fn>ushort <a name="unicode"></a>QChar::unicode () const
423</h3>
424
425<p> Returns the numeric Unicode value equal to the QChar. Normally,
426you should use QChar objects as they are equivalent, but for some
427low-level tasks (e.g. indexing into an array of Unicode
428information), this function is useful.
429
430<h3 class=fn>ushort &amp; <a name="unicode-2"></a>QChar::unicode ()
431</h3>
432
433<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
434<p> Returns a reference to the numeric Unicode value equal to the
435QChar.
436
437<h3 class=fn><a href="qchar.html">QChar</a> <a name="upper"></a>QChar::upper () const
438</h3>
439Returns the uppercase equivalent if the character is lowercase;
440otherwise returns the character itself.
441
442<hr><h2>Related Functions</h2>
443<h3 class=fn>int <a name="operator!-eq"></a>operator!= ( <a href="qchar.html">QChar</a>&nbsp;c1, <a href="qchar.html">QChar</a>&nbsp;c2 )
444</h3>
445
446<p>
447<p> Returns TRUE if <em>c1</em> and <em>c2</em> are not the same Unicode
448character; otherwise returns FALSE.
449
450<h3 class=fn>int <a name="operator!-eq-2"></a>operator!= ( char&nbsp;ch, <a href="qchar.html">QChar</a>&nbsp;c )
451</h3>
452
453<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
454<p>
455<p> Returns TRUE if <em>c</em> is not the ASCII/Latin-1 character <em>ch</em>;
456otherwise returns FALSE.
457
458<h3 class=fn>int <a name="operator!-eq-3"></a>operator!= ( <a href="qchar.html">QChar</a>&nbsp;c, char&nbsp;ch )
459</h3>
460
461<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
462<p>
463<p> Returns TRUE if <em>c</em> is not the ASCII/Latin-1 character <em>ch</em>;
464otherwise returns FALSE.
465
466<h3 class=fn>int <a name="operator-lt"></a>operator&lt; ( <a href="qchar.html">QChar</a>&nbsp;c1, <a href="qchar.html">QChar</a>&nbsp;c2 )
467</h3>
468
469<p>
470<p> Returns TRUE if the numeric Unicode value of <em>c1</em> is less than
471that of <em>c2</em>; otherwise returns FALSE.
472
473<h3 class=fn>int <a name="operator-lt-2"></a>operator&lt; ( <a href="qchar.html">QChar</a>&nbsp;c, char&nbsp;ch )
474</h3>
475
476<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
477<p>
478<p> Returns TRUE if the numeric Unicode value of <em>c</em> is less than that
479of the ASCII/Latin-1 character <em>ch</em>; otherwise returns FALSE.
480
481<h3 class=fn>int <a name="operator-lt-3"></a>operator&lt; ( char&nbsp;ch, <a href="qchar.html">QChar</a>&nbsp;c )
482</h3>
483
484<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
485<p>
486<p> Returns TRUE if the numeric Unicode value of the ASCII/Latin-1
487character <em>ch</em> is less than that of <em>c</em>; otherwise returns
488FALSE.
489
490<h3 class=fn>int <a name="operator-lt-eq"></a>operator&lt;= ( <a href="qchar.html">QChar</a>&nbsp;c1, <a href="qchar.html">QChar</a>&nbsp;c2 )
491</h3>
492
493<p>
494<p> Returns TRUE if the numeric Unicode value of <em>c1</em> is less than
495that of <em>c2</em>, or they are the same Unicode character; otherwise
496returns FALSE.
497
498<h3 class=fn>int <a name="operator-lt-eq-2"></a>operator&lt;= ( <a href="qchar.html">QChar</a>&nbsp;c, char&nbsp;ch )
499</h3>
500
501<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
502<p>
503<p> Returns TRUE if the numeric Unicode value of <em>c</em> is less than or
504equal to that of the ASCII/Latin-1 character <em>ch</em>; otherwise
505returns FALSE.
506
507<h3 class=fn>int <a name="operator-lt-eq-3"></a>operator&lt;= ( char&nbsp;ch, <a href="qchar.html">QChar</a>&nbsp;c )
508</h3>
509
510<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
511<p>
512<p> Returns TRUE if the numeric Unicode value of the ASCII/Latin-1
513character <em>ch</em> is less than or equal to that of <em>c</em>; otherwise
514returns FALSE.
515
516<h3 class=fn>bool <a name="operator-eq-eq"></a>operator== ( <a href="qchar.html">QChar</a>&nbsp;c1, <a href="qchar.html">QChar</a>&nbsp;c2 )
517</h3>
518
519<p>
520<p> Returns TRUE if <em>c1</em> and <em>c2</em> are the same Unicode character;
521otherwise returns FALSE.
522
523<h3 class=fn>bool <a name="operator-eq-eq-2"></a>operator== ( char&nbsp;ch, <a href="qchar.html">QChar</a>&nbsp;c )
524</h3>
525
526<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
527<p>
528<p> Returns TRUE if <em>c</em> is the ASCII/Latin-1 character <em>ch</em>;
529otherwise returns FALSE.
530
531<h3 class=fn>bool <a name="operator-eq-eq-3"></a>operator== ( <a href="qchar.html">QChar</a>&nbsp;c, char&nbsp;ch )
532</h3>
533
534<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
535<p>
536<p> Returns TRUE if <em>c</em> is the ASCII/Latin-1 character <em>ch</em>;
537otherwise returns FALSE.
538
539<h3 class=fn>int <a name="operator-gt"></a>operator&gt; ( <a href="qchar.html">QChar</a>&nbsp;c1, <a href="qchar.html">QChar</a>&nbsp;c2 )
540</h3>
541
542<p>
543<p> Returns TRUE if the numeric Unicode value of <em>c1</em> is greater than
544that of <em>c2</em>; otherwise returns FALSE.
545
546<h3 class=fn>int <a name="operator-gt-2"></a>operator&gt; ( <a href="qchar.html">QChar</a>&nbsp;c, char&nbsp;ch )
547</h3>
548
549<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
550<p>
551<p> Returns TRUE if the numeric Unicode value of <em>c</em> is greater than
552that of the ASCII/Latin-1 character <em>ch</em>; otherwise returns FALSE.
553
554<h3 class=fn>int <a name="operator-gt-3"></a>operator&gt; ( char&nbsp;ch, <a href="qchar.html">QChar</a>&nbsp;c )
555</h3>
556
557<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
558<p>
559<p> Returns TRUE if the numeric Unicode value of the ASCII/Latin-1
560character <em>ch</em> is greater than that of <em>c</em>; otherwise returns
561FALSE.
562
563<h3 class=fn>int <a name="operator-gt-eq"></a>operator&gt;= ( <a href="qchar.html">QChar</a>&nbsp;c1, <a href="qchar.html">QChar</a>&nbsp;c2 )
564</h3>
565
566<p>
567<p> Returns TRUE if the numeric Unicode value of <em>c1</em> is greater than
568that of <em>c2</em>, or they are the same Unicode character; otherwise
569returns FALSE.
570
571<h3 class=fn>int <a name="operator-gt-eq-2"></a>operator&gt;= ( <a href="qchar.html">QChar</a>&nbsp;c, char&nbsp;ch )
572</h3>
573
574<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
575<p>
576<p> Returns TRUE if the numeric Unicode value of <em>c</em> is greater than
577or equal to that of the ASCII/Latin-1 character <em>ch</em>; otherwise
578returns FALSE.
579
580<h3 class=fn>int <a name="operator-gt-eq-3"></a>operator&gt;= ( char&nbsp;ch, <a href="qchar.html">QChar</a>&nbsp;c )
581</h3>
582
583<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
584<p>
585<p> Returns TRUE if the numeric Unicode value of the ASCII/Latin-1
586character <em>ch</em> is greater than or equal to that of <em>c</em>;
587otherwise returns FALSE.
588
589<!-- eof -->
590<hr><p>
591This file is part of the <a href="index.html">Qt toolkit</a>.
592Copyright &copy; 1995-2007
593<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
594<table width=100% cellspacing=0 border=0><tr>
595<td>Copyright &copy; 2007
596<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
597<td align=right><div align=right>Qt 3.3.8</div>
598</table></div></address></body>
599</html>
Note: See TracBrowser for help on using the repository browser.