You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
600 lines
29 KiB
600 lines
29 KiB
14 years ago
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
||
|
|
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/tools/qstring.cpp:166 -->
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||
|
|
<title>QChar Class</title>
|
||
|
|
<style type="text/css"><!--
|
||
|
|
fn { margin-left: 1cm; text-indent: -1cm; }
|
||
|
|
a:link { color: #004faf; text-decoration: none }
|
||
|
|
a:visited { color: #672967; text-decoration: none }
|
||
|
|
body { background: #ffffff; color: black; }
|
||
|
|
--></style>
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
|
||
|
|
<table border="0" cellpadding="0" cellspacing="0" width="100%">
|
||
|
|
<tr bgcolor="#E5E5E5">
|
||
|
|
<td valign=center>
|
||
|
|
<a href="index.html">
|
||
|
|
<font color="#004faf">Home</font></a>
|
||
|
|
| <a href="classes.html">
|
||
|
|
<font color="#004faf">All Classes</font></a>
|
||
|
|
| <a href="mainclasses.html">
|
||
|
|
<font color="#004faf">Main Classes</font></a>
|
||
|
|
| <a href="annotated.html">
|
||
|
|
<font color="#004faf">Annotated</font></a>
|
||
|
|
| <a href="groups.html">
|
||
|
|
<font color="#004faf">Grouped Classes</font></a>
|
||
|
|
| <a href="functions.html">
|
||
|
|
<font color="#004faf">Functions</font></a>
|
||
|
|
</td>
|
||
|
|
<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>
|
||
|
|
|
||
|
|
<p>The QChar class provides a lightweight Unicode character.
|
||
|
|
<a href="#details">More...</a>
|
||
|
|
<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>().
|
||
|
|
</p><p><tt>#include <<a href="qstring-h.html">qstring.h</a>></tt>
|
||
|
|
<p><a href="qchar-members.html">List of all member functions.</a>
|
||
|
|
<h2>Public Members</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn><a href="#QChar"><b>QChar</b></a> ()</li>
|
||
|
|
<li class=fn><a href="#QChar-2"><b>QChar</b></a> ( char c )</li>
|
||
|
|
<li class=fn><a href="#QChar-3"><b>QChar</b></a> ( uchar c )</li>
|
||
|
|
<li class=fn><a href="#QChar-4"><b>QChar</b></a> ( uchar c, uchar r )</li>
|
||
|
|
<li class=fn><a href="#QChar-5"><b>QChar</b></a> ( const QChar & c )</li>
|
||
|
|
<li class=fn><a href="#QChar-6"><b>QChar</b></a> ( ushort rc )</li>
|
||
|
|
<li class=fn><a href="#QChar-7"><b>QChar</b></a> ( short rc )</li>
|
||
|
|
<li class=fn><a href="#QChar-8"><b>QChar</b></a> ( uint rc )</li>
|
||
|
|
<li class=fn><a href="#QChar-9"><b>QChar</b></a> ( int rc )</li>
|
||
|
|
<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>
|
||
|
|
<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>
|
||
|
|
<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>
|
||
|
|
<li class=fn>enum <a href="#Joining-enum"><b>Joining</b></a> { OtherJoining, Dual, Right, Center }</li>
|
||
|
|
<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>
|
||
|
|
<li class=fn>int <a href="#digitValue"><b>digitValue</b></a> () const</li>
|
||
|
|
<li class=fn>QChar <a href="#lower"><b>lower</b></a> () const</li>
|
||
|
|
<li class=fn>QChar <a href="#upper"><b>upper</b></a> () const</li>
|
||
|
|
<li class=fn>Category <a href="#category"><b>category</b></a> () const</li>
|
||
|
|
<li class=fn>Direction <a href="#direction"><b>direction</b></a> () const</li>
|
||
|
|
<li class=fn>Joining <a href="#joining"><b>joining</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#mirrored"><b>mirrored</b></a> () const</li>
|
||
|
|
<li class=fn>QChar <a href="#mirroredChar"><b>mirroredChar</b></a> () const</li>
|
||
|
|
<li class=fn>const QString & <a href="#decomposition"><b>decomposition</b></a> () const</li>
|
||
|
|
<li class=fn>Decomposition <a href="#decompositionTag"><b>decompositionTag</b></a> () const</li>
|
||
|
|
<li class=fn>unsigned char <a href="#combiningClass"><b>combiningClass</b></a> () const</li>
|
||
|
|
<li class=fn>char <a href="#latin1"><b>latin1</b></a> () const</li>
|
||
|
|
<li class=fn>ushort <a href="#unicode"><b>unicode</b></a> () const</li>
|
||
|
|
<li class=fn>ushort & <a href="#unicode-2"><b>unicode</b></a> ()</li>
|
||
|
|
<li class=fn><a href="#operator-char"><b>operator char</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isPrint"><b>isPrint</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isPunct"><b>isPunct</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isSpace"><b>isSpace</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isMark"><b>isMark</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isLetter"><b>isLetter</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isNumber"><b>isNumber</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isLetterOrNumber"><b>isLetterOrNumber</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isDigit"><b>isDigit</b></a> () const</li>
|
||
|
|
<li class=fn>bool <a href="#isSymbol"><b>isSymbol</b></a> () const</li>
|
||
|
|
<li class=fn>uchar <a href="#cell"><b>cell</b></a> () const</li>
|
||
|
|
<li class=fn>uchar <a href="#row"><b>row</b></a> () const</li>
|
||
|
|
</ul>
|
||
|
|
<h2>Static Public Members</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>bool networkOrdered () <em>(obsolete)</em></li>
|
||
|
|
</ul>
|
||
|
|
<h2>Related Functions</h2>
|
||
|
|
<ul>
|
||
|
|
<li class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( QChar c1, QChar c2 )</li>
|
||
|
|
<li class=fn>bool <a href="#operator-eq-eq-2"><b>operator==</b></a> ( char ch, QChar c )</li>
|
||
|
|
<li class=fn>bool <a href="#operator-eq-eq-3"><b>operator==</b></a> ( QChar c, char ch )</li>
|
||
|
|
<li class=fn>int <a href="#operator!-eq"><b>operator!=</b></a> ( QChar c1, QChar c2 )</li>
|
||
|
|
<li class=fn>int <a href="#operator!-eq-2"><b>operator!=</b></a> ( char ch, QChar c )</li>
|
||
|
|
<li class=fn>int <a href="#operator!-eq-3"><b>operator!=</b></a> ( QChar c, char ch )</li>
|
||
|
|
<li class=fn>int <a href="#operator-lt-eq"><b>operator<=</b></a> ( QChar c1, QChar c2 )</li>
|
||
|
|
<li class=fn>int <a href="#operator-lt-eq-2"><b>operator<=</b></a> ( QChar c, char ch )</li>
|
||
|
|
<li class=fn>int <a href="#operator-lt-eq-3"><b>operator<=</b></a> ( char ch, QChar c )</li>
|
||
|
|
<li class=fn>int <a href="#operator-gt-eq"><b>operator>=</b></a> ( QChar c1, QChar c2 )</li>
|
||
|
|
<li class=fn>int <a href="#operator-gt-eq-2"><b>operator>=</b></a> ( QChar c, char ch )</li>
|
||
|
|
<li class=fn>int <a href="#operator-gt-eq-3"><b>operator>=</b></a> ( char ch, QChar c )</li>
|
||
|
|
<li class=fn>int <a href="#operator-lt"><b>operator<</b></a> ( QChar c1, QChar c2 )</li>
|
||
|
|
<li class=fn>int <a href="#operator-lt-2"><b>operator<</b></a> ( QChar c, char ch )</li>
|
||
|
|
<li class=fn>int <a href="#operator-lt-3"><b>operator<</b></a> ( char ch, QChar c )</li>
|
||
|
|
<li class=fn>int <a href="#operator-gt"><b>operator></b></a> ( QChar c1, QChar c2 )</li>
|
||
|
|
<li class=fn>int <a href="#operator-gt-2"><b>operator></b></a> ( QChar c, char ch )</li>
|
||
|
|
<li class=fn>int <a href="#operator-gt-3"><b>operator></b></a> ( char ch, QChar c )</li>
|
||
|
|
</ul>
|
||
|
|
<hr><a name="details"></a><h2>Detailed Description</h2>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
The QChar class provides a lightweight Unicode character.
|
||
|
|
<p>
|
||
|
|
<p> Unicode characters are (so far) 16-bit entities without any markup
|
||
|
|
or structure. This class represents such an entity. It is
|
||
|
|
lightweight, so it can be used everywhere. Most compilers treat it
|
||
|
|
like a "short int". (In a few years it may be necessary to make
|
||
|
|
QChar 32-bit when more than 65536 Unicode code points have been
|
||
|
|
defined and come into use.)
|
||
|
|
<p> QChar provides a full complement of testing/classification
|
||
|
|
functions, converting to and from other formats, converting from
|
||
|
|
composed to decomposed Unicode, and trying to compare and
|
||
|
|
case-convert if you ask it to.
|
||
|
|
<p> The classification functions include functions like those in
|
||
|
|
ctype.h, but operating on the full range of Unicode characters.
|
||
|
|
They all return TRUE if the character is a certain type of
|
||
|
|
character; otherwise they return FALSE. These classification
|
||
|
|
functions are <a href="#isNull">isNull</a>() (returns TRUE if the character is U+0000),
|
||
|
|
<a href="#isPrint">isPrint</a>() (TRUE if the character is any sort of printable
|
||
|
|
character, including whitespace), <a href="#isPunct">isPunct</a>() (any sort of
|
||
|
|
punctation), <a href="#isMark">isMark</a>() (Unicode Mark), isLetter (a letter),
|
||
|
|
<a href="#isNumber">isNumber</a>() (any sort of numeric character), <a href="#isLetterOrNumber">isLetterOrNumber</a>(),
|
||
|
|
and <a href="#isDigit">isDigit</a>() (decimal digits). All of these are wrappers around
|
||
|
|
<a href="#category">category</a>() which return the Unicode-defined category of each
|
||
|
|
character.
|
||
|
|
<p> QChar further provides <a href="#direction">direction</a>(), which indicates the "natural"
|
||
|
|
writing direction of this character. The <a href="#joining">joining</a>() function
|
||
|
|
indicates how the character joins with its neighbors (needed
|
||
|
|
mostly for Arabic) and finally <a href="#mirrored">mirrored</a>(), which indicates whether
|
||
|
|
the character needs to be mirrored when it is printed in its
|
||
|
|
"unnatural" writing direction.
|
||
|
|
<p> Composed Unicode characters (like å) can be converted to
|
||
|
|
decomposed Unicode ("a" followed by "ring above") by using
|
||
|
|
<a href="#decomposition">decomposition</a>().
|
||
|
|
<p> In Unicode, comparison is not necessarily possible and case
|
||
|
|
conversion is very difficult at best. Unicode, covering the
|
||
|
|
"entire" world, also includes most of the world's case and sorting
|
||
|
|
problems. Qt tries, but not very hard: <a href="#operator-eq-eq">operator==</a>() and friends
|
||
|
|
will do comparison based purely on the numeric Unicode value (code
|
||
|
|
point) of the characters, and <a href="#upper">upper</a>() and <a href="#lower">lower</a>() will do case
|
||
|
|
changes when the character has a well-defined upper/lower-case
|
||
|
|
equivalent. There is no provision for locale-dependent case
|
||
|
|
folding rules or comparison; these functions are meant to be fast
|
||
|
|
so they can be used unambiguously in data structures. (See
|
||
|
|
<a href="qstring.html#localeAwareCompare">QString::localeAwareCompare</a>() though.)
|
||
|
|
<p> The conversion functions include <a href="#unicode">unicode</a>() (to a scalar), <a href="#latin1">latin1</a>()
|
||
|
|
(to scalar, but converts all non-Latin-1 characters to 0), <a href="#row">row</a>()
|
||
|
|
(gives the Unicode row), <a href="#cell">cell</a>() (gives the Unicode cell),
|
||
|
|
<a href="#digitValue">digitValue</a>() (gives the integer value of any of the numerous digit
|
||
|
|
characters), and a host of constructors.
|
||
|
|
<p> More information can be found in the document <a href="unicode.html">About Unicode.</a>
|
||
|
|
<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>.
|
||
|
|
|
||
|
|
<hr><h2>Member Type Documentation</h2>
|
||
|
|
<h3 class=fn><a name="Category-enum"></a>QChar::Category</h3>
|
||
|
|
|
||
|
|
<p> This enum maps the Unicode character categories.
|
||
|
|
<p> The following characters are normative in Unicode:
|
||
|
|
<ul>
|
||
|
|
<li><tt>QChar::Mark_NonSpacing</tt> - Unicode class name Mn
|
||
|
|
<li><tt>QChar::Mark_SpacingCombining</tt> - Unicode class name Mc
|
||
|
|
<li><tt>QChar::Mark_Enclosing</tt> - Unicode class name Me
|
||
|
|
<li><tt>QChar::Number_DecimalDigit</tt> - Unicode class name Nd
|
||
|
|
<li><tt>QChar::Number_Letter</tt> - Unicode class name Nl
|
||
|
|
<li><tt>QChar::Number_Other</tt> - Unicode class name No
|
||
|
|
<li><tt>QChar::Separator_Space</tt> - Unicode class name Zs
|
||
|
|
<li><tt>QChar::Separator_Line</tt> - Unicode class name Zl
|
||
|
|
<li><tt>QChar::Separator_Paragraph</tt> - Unicode class name Zp
|
||
|
|
<li><tt>QChar::Other_Control</tt> - Unicode class name Cc
|
||
|
|
<li><tt>QChar::Other_Format</tt> - Unicode class name Cf
|
||
|
|
<li><tt>QChar::Other_Surrogate</tt> - Unicode class name Cs
|
||
|
|
<li><tt>QChar::Other_PrivateUse</tt> - Unicode class name Co
|
||
|
|
<li><tt>QChar::Other_NotAssigned</tt> - Unicode class name Cn
|
||
|
|
</ul><p> The following categories are informative in Unicode:
|
||
|
|
<ul>
|
||
|
|
<li><tt>QChar::Letter_Uppercase</tt> - Unicode class name Lu
|
||
|
|
<li><tt>QChar::Letter_Lowercase</tt> - Unicode class name Ll
|
||
|
|
<li><tt>QChar::Letter_Titlecase</tt> - Unicode class name Lt
|
||
|
|
<li><tt>QChar::Letter_Modifier</tt> - Unicode class name Lm
|
||
|
|
<li><tt>QChar::Letter_Other</tt> - Unicode class name Lo
|
||
|
|
<li><tt>QChar::Punctuation_Connector</tt> - Unicode class name Pc
|
||
|
|
<li><tt>QChar::Punctuation_Dash</tt> - Unicode class name Pd
|
||
|
|
<li><tt>QChar::Punctuation_Open</tt> - Unicode class name Ps
|
||
|
|
<li><tt>QChar::Punctuation_Close</tt> - Unicode class name Pe
|
||
|
|
<li><tt>QChar::Punctuation_InitialQuote</tt> - Unicode class name Pi
|
||
|
|
<li><tt>QChar::Punctuation_FinalQuote</tt> - Unicode class name Pf
|
||
|
|
<li><tt>QChar::Punctuation_Other</tt> - Unicode class name Po
|
||
|
|
<li><tt>QChar::Symbol_Math</tt> - Unicode class name Sm
|
||
|
|
<li><tt>QChar::Symbol_Currency</tt> - Unicode class name Sc
|
||
|
|
<li><tt>QChar::Symbol_Modifier</tt> - Unicode class name Sk
|
||
|
|
<li><tt>QChar::Symbol_Other</tt> - Unicode class name So
|
||
|
|
</ul><p> There are two categories that are specific to Qt:
|
||
|
|
<ul>
|
||
|
|
<li><tt>QChar::NoCategory</tt> - used when Qt is dazed and confused and cannot
|
||
|
|
make sense of anything.
|
||
|
|
<li><tt>QChar::Punctuation_Dask</tt> - old typo alias for Punctuation_Dash
|
||
|
|
</ul><p>
|
||
|
|
<h3 class=fn><a name="CombiningClass-enum"></a>QChar::CombiningClass</h3>
|
||
|
|
|
||
|
|
<p> This enum type defines names for some of the Unicode combining
|
||
|
|
classes. See <a href="http://www.unicode.org/">the Unicode
|
||
|
|
Standard</a> for a description of the values.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="Decomposition-enum"></a>QChar::Decomposition</h3>
|
||
|
|
|
||
|
|
<p> This enum type defines the Unicode decomposition attributes. See
|
||
|
|
<a href="http://www.unicode.org/">the Unicode Standard</a> for a
|
||
|
|
description of the values.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="Direction-enum"></a>QChar::Direction</h3>
|
||
|
|
|
||
|
|
<p> This enum type defines the Unicode direction attributes. See <a href="http://www.unicode.org/">the Unicode Standard</a> for a
|
||
|
|
description of the values.
|
||
|
|
<p> In order to conform to C/C++ naming conventions "Dir" is prepended
|
||
|
|
to the codes used in the Unicode Standard.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="Joining-enum"></a>QChar::Joining</h3>
|
||
|
|
|
||
|
|
<p> This enum type defines the Unicode joining attributes. See <a href="http://www.unicode.org/">the Unicode Standard</a> for a
|
||
|
|
description of the values.
|
||
|
|
|
||
|
|
<hr><h2>Member Function Documentation</h2>
|
||
|
|
<h3 class=fn><a name="QChar"></a>QChar::QChar ()
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Constructs a null QChar (one that <a href="#isNull">isNull</a>()).
|
||
|
|
|
||
|
|
<h3 class=fn><a name="QChar-2"></a>QChar::QChar ( char c )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Constructs a QChar corresponding to ASCII/Latin-1 character <em>c</em>.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="QChar-3"></a>QChar::QChar ( uchar c )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Constructs a QChar corresponding to ASCII/Latin-1 character <em>c</em>.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="QChar-4"></a>QChar::QChar ( uchar c, uchar r )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Constructs a QChar for Unicode cell <em>c</em> in row <em>r</em>.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="QChar-5"></a>QChar::QChar ( const <a href="qchar.html">QChar</a> & c )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Constructs a copy of <em>c</em>. This is a <a href="shclass.html#deep-copy">deep copy</a>, if such a
|
||
|
|
lightweight object can be said to have deep copies.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="QChar-6"></a>QChar::QChar ( ushort rc )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Constructs a QChar for the character with Unicode code point <em>rc</em>.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="QChar-7"></a>QChar::QChar ( short rc )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Constructs a QChar for the character with Unicode code point <em>rc</em>.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="QChar-8"></a>QChar::QChar ( uint rc )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Constructs a QChar for the character with Unicode code point <em>rc</em>.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="QChar-9"></a>QChar::QChar ( int rc )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Constructs a QChar for the character with Unicode code point <em>rc</em>.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qchar.html#Category-enum">Category</a> <a name="category"></a>QChar::category () const
|
||
|
|
</h3>
|
||
|
|
Returns the character category.
|
||
|
|
<p> <p>See also <a href="#Category-enum">Category</a>.
|
||
|
|
|
||
|
|
<h3 class=fn>uchar <a name="cell"></a>QChar::cell () const
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Returns the cell (least significant byte) of the Unicode
|
||
|
|
character.
|
||
|
|
|
||
|
|
<h3 class=fn>unsigned char <a name="combiningClass"></a>QChar::combiningClass () const
|
||
|
|
</h3>
|
||
|
|
Returns the combining class for the character as defined in the
|
||
|
|
Unicode standard. This is mainly useful as a positioning hint for
|
||
|
|
marks attached to a base character.
|
||
|
|
<p> The Qt text rendering engine uses this information to correctly
|
||
|
|
position non spacing marks around a base character.
|
||
|
|
|
||
|
|
<h3 class=fn>const <a href="qstring.html">QString</a> & <a name="decomposition"></a>QChar::decomposition () const
|
||
|
|
</h3><p><b>Warning:</b> This function is <i>not</i> <a href="threads.html#reentrant">reentrant</a>.</p>
|
||
|
|
|
||
|
|
|
||
|
|
<p> Decomposes a character into its parts. Returns <a href="qstring.html#QString-null">QString::null</a> if no
|
||
|
|
decomposition exists.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qchar.html#Decomposition-enum">Decomposition</a> <a name="decompositionTag"></a>QChar::decompositionTag () const
|
||
|
|
</h3>
|
||
|
|
Returns the tag defining the composition of the character. Returns
|
||
|
|
QChar::Single if no decomposition exists.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="digitValue"></a>QChar::digitValue () const
|
||
|
|
</h3>
|
||
|
|
Returns the numeric value of the digit, or -1 if the character is
|
||
|
|
not a digit.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qchar.html#Direction-enum">Direction</a> <a name="direction"></a>QChar::direction () const
|
||
|
|
</h3>
|
||
|
|
Returns the character's direction.
|
||
|
|
<p> <p>See also <a href="#Direction-enum">Direction</a>.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isDigit"></a>QChar::isDigit () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a decimal digit
|
||
|
|
(Number_DecimalDigit); otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isLetter"></a>QChar::isLetter () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a letter (Letter_* categories);
|
||
|
|
otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isLetterOrNumber"></a>QChar::isLetterOrNumber () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a letter or number (Letter_* or
|
||
|
|
Number_* categories); otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isMark"></a>QChar::isMark () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a mark (Mark_* categories);
|
||
|
|
otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isNull"></a>QChar::isNull () const
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Returns TRUE if the character is the Unicode character 0x0000
|
||
|
|
(ASCII NUL); otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isNumber"></a>QChar::isNumber () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a number (of any sort - Number_*
|
||
|
|
categories); otherwise returns FALSE.
|
||
|
|
<p> <p>See also <a href="#isDigit">isDigit</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isPrint"></a>QChar::isPrint () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a printable character; otherwise
|
||
|
|
returns FALSE. This is any character not of category Cc or Cn.
|
||
|
|
<p> Note that this gives no indication of whether the character is
|
||
|
|
available in a particular <a href="qfont.html">font</a>.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isPunct"></a>QChar::isPunct () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a punctuation mark (Punctuation_*
|
||
|
|
categories); otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isSpace"></a>QChar::isSpace () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a separator character
|
||
|
|
(Separator_* categories); otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="isSymbol"></a>QChar::isSymbol () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a symbol (Symbol_* categories);
|
||
|
|
otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qchar.html#Joining-enum">Joining</a> <a name="joining"></a>QChar::joining () const
|
||
|
|
</h3>
|
||
|
|
<b>Warning:</b> This function is not supported (it may change to use
|
||
|
|
Unicode character classes).
|
||
|
|
<p> Returns information about the joining properties of the character
|
||
|
|
(needed for example, for Arabic).
|
||
|
|
|
||
|
|
<h3 class=fn>char <a name="latin1"></a>QChar::latin1 () const
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Returns the Latin-1 value of this character, or 0 if it
|
||
|
|
cannot be represented in Latin-1.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qchar.html">QChar</a> <a name="lower"></a>QChar::lower () const
|
||
|
|
</h3>
|
||
|
|
Returns the lowercase equivalent if the character is uppercase;
|
||
|
|
otherwise returns the character itself.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="mirrored"></a>QChar::mirrored () const
|
||
|
|
</h3>
|
||
|
|
Returns TRUE if the character is a mirrored character (one that
|
||
|
|
should be reversed if the text direction is reversed); otherwise
|
||
|
|
returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qchar.html">QChar</a> <a name="mirroredChar"></a>QChar::mirroredChar () const
|
||
|
|
</h3>
|
||
|
|
Returns the mirrored character if this character is a mirrored
|
||
|
|
character, otherwise returns the character itself.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="networkOrdered"></a>QChar::networkOrdered ()<tt> [static]</tt>
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
|
||
|
|
<p> Returns TRUE if this character is in network byte order (MSB
|
||
|
|
first); otherwise returns FALSE. This is platform dependent.
|
||
|
|
|
||
|
|
<h3 class=fn><a name="operator-char"></a>QChar::operator char () const
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Returns the Latin-1 character equivalent to the QChar, or 0. This
|
||
|
|
is mainly useful for non-internationalized software.
|
||
|
|
<p> <p>See also <a href="#unicode">unicode</a>().
|
||
|
|
|
||
|
|
<h3 class=fn>uchar <a name="row"></a>QChar::row () const
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Returns the row (most significant byte) of the Unicode character.
|
||
|
|
|
||
|
|
<h3 class=fn>ushort <a name="unicode"></a>QChar::unicode () const
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> Returns the numeric Unicode value equal to the QChar. Normally,
|
||
|
|
you should use QChar objects as they are equivalent, but for some
|
||
|
|
low-level tasks (e.g. indexing into an array of Unicode
|
||
|
|
information), this function is useful.
|
||
|
|
|
||
|
|
<h3 class=fn>ushort & <a name="unicode-2"></a>QChar::unicode ()
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p> Returns a reference to the numeric Unicode value equal to the
|
||
|
|
QChar.
|
||
|
|
|
||
|
|
<h3 class=fn><a href="qchar.html">QChar</a> <a name="upper"></a>QChar::upper () const
|
||
|
|
</h3>
|
||
|
|
Returns the uppercase equivalent if the character is lowercase;
|
||
|
|
otherwise returns the character itself.
|
||
|
|
|
||
|
|
<hr><h2>Related Functions</h2>
|
||
|
|
<h3 class=fn>int <a name="operator!-eq"></a>operator!= ( <a href="qchar.html">QChar</a> c1, <a href="qchar.html">QChar</a> c2 )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if <em>c1</em> and <em>c2</em> are not the same Unicode
|
||
|
|
character; otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator!-eq-2"></a>operator!= ( char ch, <a href="qchar.html">QChar</a> c )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if <em>c</em> is not the ASCII/Latin-1 character <em>ch</em>;
|
||
|
|
otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator!-eq-3"></a>operator!= ( <a href="qchar.html">QChar</a> c, char ch )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if <em>c</em> is not the ASCII/Latin-1 character <em>ch</em>;
|
||
|
|
otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-lt"></a>operator< ( <a href="qchar.html">QChar</a> c1, <a href="qchar.html">QChar</a> c2 )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of <em>c1</em> is less than
|
||
|
|
that of <em>c2</em>; otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-lt-2"></a>operator< ( <a href="qchar.html">QChar</a> c, char ch )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of <em>c</em> is less than that
|
||
|
|
of the ASCII/Latin-1 character <em>ch</em>; otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-lt-3"></a>operator< ( char ch, <a href="qchar.html">QChar</a> c )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of the ASCII/Latin-1
|
||
|
|
character <em>ch</em> is less than that of <em>c</em>; otherwise returns
|
||
|
|
FALSE.
|
||
|
|
|
||
|
|
<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 )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of <em>c1</em> is less than
|
||
|
|
that of <em>c2</em>, or they are the same Unicode character; otherwise
|
||
|
|
returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-lt-eq-2"></a>operator<= ( <a href="qchar.html">QChar</a> c, char ch )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of <em>c</em> is less than or
|
||
|
|
equal to that of the ASCII/Latin-1 character <em>ch</em>; otherwise
|
||
|
|
returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-lt-eq-3"></a>operator<= ( char ch, <a href="qchar.html">QChar</a> c )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of the ASCII/Latin-1
|
||
|
|
character <em>ch</em> is less than or equal to that of <em>c</em>; otherwise
|
||
|
|
returns FALSE.
|
||
|
|
|
||
|
|
<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 )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if <em>c1</em> and <em>c2</em> are the same Unicode character;
|
||
|
|
otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="operator-eq-eq-2"></a>operator== ( char ch, <a href="qchar.html">QChar</a> c )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if <em>c</em> is the ASCII/Latin-1 character <em>ch</em>;
|
||
|
|
otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>bool <a name="operator-eq-eq-3"></a>operator== ( <a href="qchar.html">QChar</a> c, char ch )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if <em>c</em> is the ASCII/Latin-1 character <em>ch</em>;
|
||
|
|
otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-gt"></a>operator> ( <a href="qchar.html">QChar</a> c1, <a href="qchar.html">QChar</a> c2 )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of <em>c1</em> is greater than
|
||
|
|
that of <em>c2</em>; otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-gt-2"></a>operator> ( <a href="qchar.html">QChar</a> c, char ch )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of <em>c</em> is greater than
|
||
|
|
that of the ASCII/Latin-1 character <em>ch</em>; otherwise returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-gt-3"></a>operator> ( char ch, <a href="qchar.html">QChar</a> c )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of the ASCII/Latin-1
|
||
|
|
character <em>ch</em> is greater than that of <em>c</em>; otherwise returns
|
||
|
|
FALSE.
|
||
|
|
|
||
|
|
<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 )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of <em>c1</em> is greater than
|
||
|
|
that of <em>c2</em>, or they are the same Unicode character; otherwise
|
||
|
|
returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-gt-eq-2"></a>operator>= ( <a href="qchar.html">QChar</a> c, char ch )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of <em>c</em> is greater than
|
||
|
|
or equal to that of the ASCII/Latin-1 character <em>ch</em>; otherwise
|
||
|
|
returns FALSE.
|
||
|
|
|
||
|
|
<h3 class=fn>int <a name="operator-gt-eq-3"></a>operator>= ( char ch, <a href="qchar.html">QChar</a> c )
|
||
|
|
</h3>
|
||
|
|
|
||
|
|
<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
|
||
|
|
<p>
|
||
|
|
<p> Returns TRUE if the numeric Unicode value of the ASCII/Latin-1
|
||
|
|
character <em>ch</em> is greater than or equal to that of <em>c</em>;
|
||
|
|
otherwise returns FALSE.
|
||
|
|
|
||
|
|
<!-- eof -->
|
||
|
|
<hr><p>
|
||
|
|
This file is part of the <a href="index.html">Qt toolkit</a>.
|
||
|
|
Copyright © 1995-2007
|
||
|
|
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
|
||
|
|
<table width=100% cellspacing=0 border=0><tr>
|
||
|
|
<td>Copyright © 2007
|
||
|
|
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
|
||
|
|
<td align=right><div align=right>Qt 3.3.8</div>
|
||
|
|
</table></div></address></body>
|
||
|
|
</html>
|