<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.1-reggie-23625/qt-x11-free-3.1.1/src/codecs/qrtlcodec.cpp:358 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QHebrewCodec Class</title>
<style type="text/css"><!--
h3.fn,span.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>QHebrewCodec Class Reference</h1>
<p>The QHebrewCodec class provides conversion to and from visually ordered Hebrew.
<a href="#details">More...</a>
<p>All the functions in this class are <a href="threads.html#reentrant">reentrant</a> when Qt is built with thread support.</p>
<p><tt>#include <<a href="qrtlcodec-h.html">qrtlcodec.h</a>></tt>
<p>Inherits <a href="qtextcodec.html">QTextCodec</a>.
<p><a href="qhebrewcodec-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li><div class=fn>virtual const char * <a href="#mimeName"><b>mimeName</b></a> () const</div></li>
<li><div class=fn>virtual QCString <a href="#fromUnicode"><b>fromUnicode</b></a> ( const QString & uc, int & lenInOut ) const</div></li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
<p> The QHebrewCodec class provides conversion to and from visually ordered Hebrew.
<p> Hebrew as a semitic language is written from right to left. Because
older computer systems couldn't handle reordering a string so that
the first letter appears on the right, many older documents were
encoded in visual order, so that the first letter of a line is the
rightmost one in the string.
<p> In contrast to this, Unicode defines characters to be in logical
order (the order you would read the string). This codec tries to
convert visually ordered Hebrew (8859-8) to Unicode. This might not
always work perfectly, because reversing the bidi (bi-directional)
algorithm that transforms from logical to visual order is
non-trivial.
<p> Transformation from Unicode to visual Hebrew (8859-8) is done using
the bidi algorithm in Qt, and will produce correct results, so long
as the codec is given the text one whole paragraph at a time. Places
where newlines are supposed to start can be indicated by a newline
character ('\n'). Please be aware, that these newline characters
change the reordering behaviour of the algorithm, as the BiDi
reordering only takes place within one line of text, whereas
linebreaks are determined in visual order.
<p> Visually ordered Hebrew is still used quite often in some places,
mainly in email communication (as most email programs still don't
understand logically ordered Hebrew) and on web pages. The use on
web pages is strongly decreasing however, as there are now a few
browsers that correctly support logically ordered Hebrew.
<p> This codec has the name "iso8859-8". If you don't want any bidi
reordering to happen during conversion, use the "iso8859-8-i" codec,
which assumes logical order for the 8-bit string.
<p>See also <a href="i18n.html">Internationalization with Qt</a>.
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a href="qcstring.html">QCString</a> <a name="fromUnicode"></a>QHebrewCodec::fromUnicode ( const <a href="qstring.html">QString</a> & uc, int & lenInOut ) const<tt> [virtual]</tt>
</h3>
Transforms the logically ordered <a href="qstring.html">QString</a>, <em>uc</em>, into a visually
ordered string in the 8859-8 encoding. Qt's bidi algorithm is used to
perform this task. Note that newline characters affect the
reordering, as reordering is done on a line by line basis.
<p> The algorithm is designed to work on whole paragraphs of text, so
processing a line at a time may produce incorrect results. This
approach is taken because the reordering of the contents of a
particular line in a paragraph may depend on the previous line in
the same paragraph.
<p> Some encodings (for example Japanese or utf8) are multibye (so one
input character is mapped to two output characters). The <em>lenInOut</em>
argument specifies the number of QChars that should be converted and
is set to the number of characters returned.
<p>Reimplemented from <a href="qtextcodec.html#fromUnicode">QTextCodec</a>.
<h3 class=fn>const char * <a name="mimeName"></a>QHebrewCodec::mimeName () const<tt> [virtual]</tt>
</h3>
Returns the codec's mime name.
<p>Reimplemented from <a href="qtextcodec.html#mimeName">QTextCodec</a>.
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright © 1995-2002
<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 © 2002
<a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt version 3.1.1</div>
</table></div></address></body>
</html>
