QHebrewCodec(3qt)

📦 version 3.3.8b, in fedora 43, fedora 44

💖 QHebrewCodec — the 3qt manual page, bestie edition 💖

okay so real talk, this is QHebrewCodec(3qt) and it's about conversion to and from visually ordered Hebrew. yes it's niche. yes it's iconic. let's get into it 🌸

✨ NAME ✨

QHebrewCodec — conversion to and from visually ordered Hebrew 💅

🎀 SYNOPSIS 🎀

lowkey the important part first: all the functions in this class are reentrant when Qt is built with thread support.

also there's a stray </p> in the original and honestly? we respect the chaos. it stays.
</p>

#include <qrtlcodec.h>

Inherits QTextCodec. 👑

🌈 Public Members 🌈

  • virtual const char * mimeName () const
  • virtual QCString fromUnicode ( const QString & uc, int & lenInOut ) const

🦋 DESCRIPTION 🦋

The QHebrewCodec class provides conversion to and from visually ordered Hebrew. that's the whole job. that's the assignment. 💜

so here's the lore: Hebrew, as a semitic language, is written from right to left. but older computer systems couldn't handle reordering a string so that the first letter appears on the right — they simply could not do it, it was not giving — so a LOT of older documents got encoded in visual order, where the first letter of a line is the rightmost one in the string. yes really. the string is literally backwards compared to how you read it. 😭

Unicode, by contrast, defines characters to be in logical order (the order you would actually read the string). so this codec tries to convert visually ordered Hebrew (8859-8) to Unicode. and here's the honest disclaimer: this might not always work perfectly, because reversing the bidi (bi-directional) algorithm that transforms from logical to visual order is non-trivial. it's giving "unsolved math problem energy" ngl.

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 a whole paragraph at a time. places where newlines are supposed to go can be indicated by a newline character ('\n'). ⚠️ but heads up: these newline characters change the reordering behaviour of the algorithm, since the bidi reordering only takes place within one line of text, whereas line breaks are determined in visual order. sneaky little detail but it matters fr fr.

Visually ordered Hebrew is still used quite often in some places, mainly in email communication (since most email programs still don't understand logically ordered Hebrew) and on web pages. the web page usage is rapidly decreasing though, due to the availability of browsers that correctly support logically ordered Hebrew. we love to see the glow-up 📉✨

this codec has the name "iso8859-8". and 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. pick your fighter 🥊

See also Internationalization with Qt.

💅 MEMBER FUNCTION DOCUMENTATION 💅

🧚 QCString QHebrewCodec::fromUnicode ( const QString & uc, int & lenInOut ) const

[virtual]

Transforms the logically ordered QString, uc, 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, since reordering is done on a line by line basis. 🧵

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. so yeah, don't feed it one line at a time, bestie, it will simply not eat. 🙈

Some encodings (for example Japanese or UTF-8) are multibyte (so one input character is mapped to two output characters). the lenInOut argument specifies the number of QChars that should be converted and is set to the number of characters returned.

Reimplemented from QTextCodec.

🍓 const char * QHebrewCodec::mimeName () const

[virtual]

Returns the codec's mime name. short king, one line, we stan. 👑

Reimplemented from QTextCodec.

⭐ SEE ALSO ⭐

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.

🌸 AUTHOR 🌸

Generated automatically from the source code. (not a human, not a bot, just vibes and a build script 🫶)

💀 BUGS 💀

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. 🥺 (genuinely, they mean it, good bug reports are the love language of maintainers)

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. 🫠

If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qhebrewcodec.3qt) and the Qt version (3.3.8). that's the whole recipe, don't forget either ingredient bestie 🙏

and that's the page!! 💖 this absolute gem was brought to you by Trolltech AS, dated 2 February 2007, running on Qt version 3.3.8 — no cap, that's the footer, love u, bye!! 🎀✨

📦 where this page comes from