| 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"><!--
|
|---|
| 8 | fn { margin-left: 1cm; text-indent: -1cm; }
|
|---|
| 9 | a:link { color: #004faf; text-decoration: none }
|
|---|
| 10 | a:visited { color: #672967; text-decoration: none }
|
|---|
| 11 | body { 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 Classes</font></a>
|
|---|
| 23 | | <a href="mainclasses.html">
|
|---|
| 24 | <font color="#004faf">Main 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 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 <<a href="qstring-h.html">qstring.h</a>></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 c )</li>
|
|---|
| 43 | <li class=fn><a href="#QChar-3"><b>QChar</b></a> ( uchar c )</li>
|
|---|
| 44 | <li class=fn><a href="#QChar-4"><b>QChar</b></a> ( uchar c, uchar r )</li>
|
|---|
| 45 | <li class=fn><a href="#QChar-5"><b>QChar</b></a> ( const QChar & c )</li>
|
|---|
| 46 | <li class=fn><a href="#QChar-6"><b>QChar</b></a> ( ushort rc )</li>
|
|---|
| 47 | <li class=fn><a href="#QChar-7"><b>QChar</b></a> ( short rc )</li>
|
|---|
| 48 | <li class=fn><a href="#QChar-8"><b>QChar</b></a> ( uint rc )</li>
|
|---|
| 49 | <li class=fn><a href="#QChar-9"><b>QChar</b></a> ( int 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 & <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 & <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 () <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 c1, QChar c2 )</li>
|
|---|
| 90 | <li class=fn>bool <a href="#operator-eq-eq-2"><b>operator==</b></a> ( char ch, QChar c )</li>
|
|---|
| 91 | <li class=fn>bool <a href="#operator-eq-eq-3"><b>operator==</b></a> ( QChar c, char ch )</li>
|
|---|
| 92 | <li class=fn>int <a href="#operator!-eq"><b>operator!=</b></a> ( QChar c1, QChar c2 )</li>
|
|---|
| 93 | <li class=fn>int <a href="#operator!-eq-2"><b>operator!=</b></a> ( char ch, QChar c )</li>
|
|---|
| 94 | <li class=fn>int <a href="#operator!-eq-3"><b>operator!=</b></a> ( QChar c, char ch )</li>
|
|---|
| 95 | <li class=fn>int <a href="#operator-lt-eq"><b>operator<=</b></a> ( QChar c1, QChar c2 )</li>
|
|---|
| 96 | <li class=fn>int <a href="#operator-lt-eq-2"><b>operator<=</b></a> ( QChar c, char ch )</li>
|
|---|
| 97 | <li class=fn>int <a href="#operator-lt-eq-3"><b>operator<=</b></a> ( char ch, QChar c )</li>
|
|---|
| 98 | <li class=fn>int <a href="#operator-gt-eq"><b>operator>=</b></a> ( QChar c1, QChar c2 )</li>
|
|---|
| 99 | <li class=fn>int <a href="#operator-gt-eq-2"><b>operator>=</b></a> ( QChar c, char ch )</li>
|
|---|
| 100 | <li class=fn>int <a href="#operator-gt-eq-3"><b>operator>=</b></a> ( char ch, QChar c )</li>
|
|---|
| 101 | <li class=fn>int <a href="#operator-lt"><b>operator<</b></a> ( QChar c1, QChar c2 )</li>
|
|---|
| 102 | <li class=fn>int <a href="#operator-lt-2"><b>operator<</b></a> ( QChar c, char ch )</li>
|
|---|
| 103 | <li class=fn>int <a href="#operator-lt-3"><b>operator<</b></a> ( char ch, QChar c )</li>
|
|---|
| 104 | <li class=fn>int <a href="#operator-gt"><b>operator></b></a> ( QChar c1, QChar c2 )</li>
|
|---|
| 105 | <li class=fn>int <a href="#operator-gt-2"><b>operator></b></a> ( QChar c, char ch )</li>
|
|---|
| 106 | <li class=fn>int <a href="#operator-gt-3"><b>operator></b></a> ( char ch, QChar c )</li>
|
|---|
| 107 | </ul>
|
|---|
| 108 | <hr><a name="details"></a><h2>Detailed Description</h2>
|
|---|
| 109 |
|
|---|
| 110 |
|
|---|
| 111 |
|
|---|
| 112 | The QChar class provides a lightweight Unicode character.
|
|---|
| 113 | <p>
|
|---|
| 114 | <p> Unicode characters are (so far) 16-bit entities without any markup
|
|---|
| 115 | or structure. This class represents such an entity. It is
|
|---|
| 116 | lightweight, so it can be used everywhere. Most compilers treat it
|
|---|
| 117 | like a "short int". (In a few years it may be necessary to make
|
|---|
| 118 | QChar 32-bit when more than 65536 Unicode code points have been
|
|---|
| 119 | defined and come into use.)
|
|---|
| 120 | <p> QChar provides a full complement of testing/classification
|
|---|
| 121 | functions, converting to and from other formats, converting from
|
|---|
| 122 | composed to decomposed Unicode, and trying to compare and
|
|---|
| 123 | case-convert if you ask it to.
|
|---|
| 124 | <p> The classification functions include functions like those in
|
|---|
| 125 | ctype.h, but operating on the full range of Unicode characters.
|
|---|
| 126 | They all return TRUE if the character is a certain type of
|
|---|
| 127 | character; otherwise they return FALSE. These classification
|
|---|
| 128 | functions 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
|
|---|
| 130 | character, including whitespace), <a href="#isPunct">isPunct</a>() (any sort of
|
|---|
| 131 | punctation), <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>(),
|
|---|
| 133 | and <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
|
|---|
| 135 | character.
|
|---|
| 136 | <p> QChar further provides <a href="#direction">direction</a>(), which indicates the "natural"
|
|---|
| 137 | writing direction of this character. The <a href="#joining">joining</a>() function
|
|---|
| 138 | indicates how the character joins with its neighbors (needed
|
|---|
| 139 | mostly for Arabic) and finally <a href="#mirrored">mirrored</a>(), which indicates whether
|
|---|
| 140 | the character needs to be mirrored when it is printed in its
|
|---|
| 141 | "unnatural" writing direction.
|
|---|
| 142 | <p> Composed Unicode characters (like å) can be converted to
|
|---|
| 143 | decomposed 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
|
|---|
| 146 | conversion is very difficult at best. Unicode, covering the
|
|---|
| 147 | "entire" world, also includes most of the world's case and sorting
|
|---|
| 148 | problems. Qt tries, but not very hard: <a href="#operator-eq-eq">operator==</a>() and friends
|
|---|
| 149 | will do comparison based purely on the numeric Unicode value (code
|
|---|
| 150 | point) of the characters, and <a href="#upper">upper</a>() and <a href="#lower">lower</a>() will do case
|
|---|
| 151 | changes when the character has a well-defined upper/lower-case
|
|---|
| 152 | equivalent. There is no provision for locale-dependent case
|
|---|
| 153 | folding rules or comparison; these functions are meant to be fast
|
|---|
| 154 | so 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
|
|---|
| 160 | characters), 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
|
|---|
| 205 | make 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
|
|---|
| 211 | classes. 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
|
|---|
| 218 | description 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
|
|---|
| 223 | description of the values.
|
|---|
| 224 | <p> In order to conform to C/C++ naming conventions "Dir" is prepended
|
|---|
| 225 | to 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
|
|---|
| 230 | description 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 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 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 c, uchar 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 <a href="qchar.html">QChar</a> & 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
|
|---|
| 257 | lightweight object can be said to have deep copies.
|
|---|
| 258 |
|
|---|
| 259 | <h3 class=fn><a name="QChar-6"></a>QChar::QChar ( ushort 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 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 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 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>
|
|---|
| 281 | Returns 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
|
|---|
| 288 | character.
|
|---|
| 289 |
|
|---|
| 290 | <h3 class=fn>unsigned char <a name="combiningClass"></a>QChar::combiningClass () const
|
|---|
| 291 | </h3>
|
|---|
| 292 | Returns the combining class for the character as defined in the
|
|---|
| 293 | Unicode standard. This is mainly useful as a positioning hint for
|
|---|
| 294 | marks attached to a base character.
|
|---|
| 295 | <p> The Qt text rendering engine uses this information to correctly
|
|---|
| 296 | position non spacing marks around a base character.
|
|---|
| 297 |
|
|---|
| 298 | <h3 class=fn>const <a href="qstring.html">QString</a> & <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
|
|---|
| 303 | decomposition exists.
|
|---|
| 304 |
|
|---|
| 305 | <h3 class=fn><a href="qchar.html#Decomposition-enum">Decomposition</a> <a name="decompositionTag"></a>QChar::decompositionTag () const
|
|---|
| 306 | </h3>
|
|---|
| 307 | Returns the tag defining the composition of the character. Returns
|
|---|
| 308 | QChar::Single if no decomposition exists.
|
|---|
| 309 |
|
|---|
| 310 | <h3 class=fn>int <a name="digitValue"></a>QChar::digitValue () const
|
|---|
| 311 | </h3>
|
|---|
| 312 | Returns the numeric value of the digit, or -1 if the character is
|
|---|
| 313 | not a digit.
|
|---|
| 314 |
|
|---|
| 315 | <h3 class=fn><a href="qchar.html#Direction-enum">Direction</a> <a name="direction"></a>QChar::direction () const
|
|---|
| 316 | </h3>
|
|---|
| 317 | Returns 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>
|
|---|
| 322 | Returns 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>
|
|---|
| 327 | Returns TRUE if the character is a letter (Letter_* categories);
|
|---|
| 328 | otherwise returns FALSE.
|
|---|
| 329 |
|
|---|
| 330 | <h3 class=fn>bool <a name="isLetterOrNumber"></a>QChar::isLetterOrNumber () const
|
|---|
| 331 | </h3>
|
|---|
| 332 | Returns TRUE if the character is a letter or number (Letter_* or
|
|---|
| 333 | Number_* categories); otherwise returns FALSE.
|
|---|
| 334 |
|
|---|
| 335 | <h3 class=fn>bool <a name="isMark"></a>QChar::isMark () const
|
|---|
| 336 | </h3>
|
|---|
| 337 | Returns TRUE if the character is a mark (Mark_* categories);
|
|---|
| 338 | otherwise 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>
|
|---|
| 348 | Returns TRUE if the character is a number (of any sort - Number_*
|
|---|
| 349 | categories); 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>
|
|---|
| 354 | Returns TRUE if the character is a printable character; otherwise
|
|---|
| 355 | returns FALSE. This is any character not of category Cc or Cn.
|
|---|
| 356 | <p> Note that this gives no indication of whether the character is
|
|---|
| 357 | available in a particular <a href="qfont.html">font</a>.
|
|---|
| 358 |
|
|---|
| 359 | <h3 class=fn>bool <a name="isPunct"></a>QChar::isPunct () const
|
|---|
| 360 | </h3>
|
|---|
| 361 | Returns TRUE if the character is a punctuation mark (Punctuation_*
|
|---|
| 362 | categories); otherwise returns FALSE.
|
|---|
| 363 |
|
|---|
| 364 | <h3 class=fn>bool <a name="isSpace"></a>QChar::isSpace () const
|
|---|
| 365 | </h3>
|
|---|
| 366 | Returns 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>
|
|---|
| 371 | Returns TRUE if the character is a symbol (Symbol_* categories);
|
|---|
| 372 | otherwise 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
|
|---|
| 377 | Unicode 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
|
|---|
| 385 | cannot 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>
|
|---|
| 389 | Returns the lowercase equivalent if the character is uppercase;
|
|---|
| 390 | otherwise returns the character itself.
|
|---|
| 391 |
|
|---|
| 392 | <h3 class=fn>bool <a name="mirrored"></a>QChar::mirrored () const
|
|---|
| 393 | </h3>
|
|---|
| 394 | Returns TRUE if the character is a mirrored character (one that
|
|---|
| 395 | should be reversed if the text direction is reversed); otherwise
|
|---|
| 396 | returns FALSE.
|
|---|
| 397 |
|
|---|
| 398 | <h3 class=fn><a href="qchar.html">QChar</a> <a name="mirroredChar"></a>QChar::mirroredChar () const
|
|---|
| 399 | </h3>
|
|---|
| 400 | Returns the mirrored character if this character is a mirrored
|
|---|
| 401 | character, 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
|
|---|
| 408 | first); 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
|
|---|
| 414 | is 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,
|
|---|
| 426 | you should use QChar objects as they are equivalent, but for some
|
|---|
| 427 | low-level tasks (e.g. indexing into an array of Unicode
|
|---|
| 428 | information), this function is useful.
|
|---|
| 429 |
|
|---|
| 430 | <h3 class=fn>ushort & <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
|
|---|
| 435 | QChar.
|
|---|
| 436 |
|
|---|
| 437 | <h3 class=fn><a href="qchar.html">QChar</a> <a name="upper"></a>QChar::upper () const
|
|---|
| 438 | </h3>
|
|---|
| 439 | Returns the uppercase equivalent if the character is lowercase;
|
|---|
| 440 | otherwise 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> c1, <a href="qchar.html">QChar</a> c2 )
|
|---|
| 444 | </h3>
|
|---|
| 445 |
|
|---|
| 446 | <p>
|
|---|
| 447 | <p> Returns TRUE if <em>c1</em> and <em>c2</em> are not the same Unicode
|
|---|
| 448 | character; otherwise returns FALSE.
|
|---|
| 449 |
|
|---|
| 450 | <h3 class=fn>int <a name="operator!-eq-2"></a>operator!= ( char ch, <a href="qchar.html">QChar</a> 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>;
|
|---|
| 456 | otherwise returns FALSE.
|
|---|
| 457 |
|
|---|
| 458 | <h3 class=fn>int <a name="operator!-eq-3"></a>operator!= ( <a href="qchar.html">QChar</a> c, char 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>;
|
|---|
| 464 | otherwise returns FALSE.
|
|---|
| 465 |
|
|---|
| 466 | <h3 class=fn>int <a name="operator-lt"></a>operator< ( <a href="qchar.html">QChar</a> c1, <a href="qchar.html">QChar</a> c2 )
|
|---|
| 467 | </h3>
|
|---|
| 468 |
|
|---|
| 469 | <p>
|
|---|
| 470 | <p> Returns TRUE if the numeric Unicode value of <em>c1</em> is less than
|
|---|
| 471 | that of <em>c2</em>; otherwise returns FALSE.
|
|---|
| 472 |
|
|---|
| 473 | <h3 class=fn>int <a name="operator-lt-2"></a>operator< ( <a href="qchar.html">QChar</a> c, char 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
|
|---|
| 479 | of the ASCII/Latin-1 character <em>ch</em>; otherwise returns FALSE.
|
|---|
| 480 |
|
|---|
| 481 | <h3 class=fn>int <a name="operator-lt-3"></a>operator< ( char ch, <a href="qchar.html">QChar</a> 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
|
|---|
| 487 | character <em>ch</em> is less than that of <em>c</em>; otherwise returns
|
|---|
| 488 | FALSE.
|
|---|
| 489 |
|
|---|
| 490 | <h3 class=fn>int <a name="operator-lt-eq"></a>operator<= ( <a href="qchar.html">QChar</a> c1, <a href="qchar.html">QChar</a> c2 )
|
|---|
| 491 | </h3>
|
|---|
| 492 |
|
|---|
| 493 | <p>
|
|---|
| 494 | <p> Returns TRUE if the numeric Unicode value of <em>c1</em> is less than
|
|---|
| 495 | that of <em>c2</em>, or they are the same Unicode character; otherwise
|
|---|
| 496 | returns FALSE.
|
|---|
| 497 |
|
|---|
| 498 | <h3 class=fn>int <a name="operator-lt-eq-2"></a>operator<= ( <a href="qchar.html">QChar</a> c, char 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
|
|---|
| 504 | equal to that of the ASCII/Latin-1 character <em>ch</em>; otherwise
|
|---|
| 505 | returns FALSE.
|
|---|
| 506 |
|
|---|
| 507 | <h3 class=fn>int <a name="operator-lt-eq-3"></a>operator<= ( char ch, <a href="qchar.html">QChar</a> 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
|
|---|
| 513 | character <em>ch</em> is less than or equal to that of <em>c</em>; otherwise
|
|---|
| 514 | returns FALSE.
|
|---|
| 515 |
|
|---|
| 516 | <h3 class=fn>bool <a name="operator-eq-eq"></a>operator== ( <a href="qchar.html">QChar</a> c1, <a href="qchar.html">QChar</a> c2 )
|
|---|
| 517 | </h3>
|
|---|
| 518 |
|
|---|
| 519 | <p>
|
|---|
| 520 | <p> Returns TRUE if <em>c1</em> and <em>c2</em> are the same Unicode character;
|
|---|
| 521 | otherwise returns FALSE.
|
|---|
| 522 |
|
|---|
| 523 | <h3 class=fn>bool <a name="operator-eq-eq-2"></a>operator== ( char ch, <a href="qchar.html">QChar</a> 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>;
|
|---|
| 529 | otherwise returns FALSE.
|
|---|
| 530 |
|
|---|
| 531 | <h3 class=fn>bool <a name="operator-eq-eq-3"></a>operator== ( <a href="qchar.html">QChar</a> c, char 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>;
|
|---|
| 537 | otherwise returns FALSE.
|
|---|
| 538 |
|
|---|
| 539 | <h3 class=fn>int <a name="operator-gt"></a>operator> ( <a href="qchar.html">QChar</a> c1, <a href="qchar.html">QChar</a> c2 )
|
|---|
| 540 | </h3>
|
|---|
| 541 |
|
|---|
| 542 | <p>
|
|---|
| 543 | <p> Returns TRUE if the numeric Unicode value of <em>c1</em> is greater than
|
|---|
| 544 | that of <em>c2</em>; otherwise returns FALSE.
|
|---|
| 545 |
|
|---|
| 546 | <h3 class=fn>int <a name="operator-gt-2"></a>operator> ( <a href="qchar.html">QChar</a> c, char 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
|
|---|
| 552 | that 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> ( char ch, <a href="qchar.html">QChar</a> 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
|
|---|
| 560 | character <em>ch</em> is greater than that of <em>c</em>; otherwise returns
|
|---|
| 561 | FALSE.
|
|---|
| 562 |
|
|---|
| 563 | <h3 class=fn>int <a name="operator-gt-eq"></a>operator>= ( <a href="qchar.html">QChar</a> c1, <a href="qchar.html">QChar</a> c2 )
|
|---|
| 564 | </h3>
|
|---|
| 565 |
|
|---|
| 566 | <p>
|
|---|
| 567 | <p> Returns TRUE if the numeric Unicode value of <em>c1</em> is greater than
|
|---|
| 568 | that of <em>c2</em>, or they are the same Unicode character; otherwise
|
|---|
| 569 | returns FALSE.
|
|---|
| 570 |
|
|---|
| 571 | <h3 class=fn>int <a name="operator-gt-eq-2"></a>operator>= ( <a href="qchar.html">QChar</a> c, char 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
|
|---|
| 577 | or equal to that of the ASCII/Latin-1 character <em>ch</em>; otherwise
|
|---|
| 578 | returns FALSE.
|
|---|
| 579 |
|
|---|
| 580 | <h3 class=fn>int <a name="operator-gt-eq-3"></a>operator>= ( char ch, <a href="qchar.html">QChar</a> 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
|
|---|
| 586 | character <em>ch</em> is greater than or equal to that of <em>c</em>;
|
|---|
| 587 | otherwise returns FALSE.
|
|---|
| 588 |
|
|---|
| 589 | <!-- eof -->
|
|---|
| 590 | <hr><p>
|
|---|
| 591 | This file is part of the <a href="index.html">Qt toolkit</a>.
|
|---|
| 592 | Copyright © 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 © 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>
|
|---|
