<html>
<head>
<title>Data of Class _rtl_TextEncodingInfo</title>
<link rel="stylesheet" type="text/css" href="../../cpp.css">
</head>
<body>
<div id="adc-cppref">
<a name="_top_"> </a><table class="navimain" border="0" cellpadding="1" cellspacing="0">
<tr align="center" valign="top">
<td class="navimain"> <a href="../../index.html">Overview</a> </td>
<td class="navimain"> <a href="../index.html">Namespace</a> </td>
<td class="navimain"> <a href="../c-_rtl_TextEncodingInfo.html">Class</a> </td>
<td class="navimain"> <a href="../../index-files/index-1.html">Index</a> </td>
<td class="navimain"> <a href="../../help.html">Help</a> </td>
</tr>
</table>
<table class="navisub" cellpadding="0" cellspacing="3"></table>
<hr>
<div class="title"><h2>Data of Class _rtl_TextEncodingInfo</h2>
</div><hr>
<dl class="member">
<dt class="member"><a name="StructSize"> </a>StructSize</dt>
<dd class="member"><a href="../t-sal_uInt32.html">sal_uInt32</a> <strong>StructSize</strong>;<br>
<br>
</dd>
<dd class="member"><dl>
<dt>Summary</dt>
<dd>The size (in bytes) of this structure. Should be 12.
</dd>
</dl>
</dd>
</dl>
<hr>
<dl class="member">
<dt class="member"><a name="MinimumCharSize"> </a>MinimumCharSize</dt>
<dd class="member"><a href="../t-sal_uInt8.html">sal_uInt8</a> <strong>MinimumCharSize</strong>;<br>
<br>
</dd>
<dd class="member"><dl>
<dt>Summary</dt>
<dd>The minimum number of bytes needed to encode any character in the
given encoding.
</dd>
<dt>Description</dt>
<dd>Can be rather meaningless for encodings that encode global state along
with the characters (e.g., ISO-2022 encodings).
</dd>
</dl>
</dd>
</dl>
<hr>
<dl class="member">
<dt class="member"><a name="MaximumCharSize"> </a>MaximumCharSize</dt>
<dd class="member"><a href="../t-sal_uInt8.html">sal_uInt8</a> <strong>MaximumCharSize</strong>;<br>
<br>
</dd>
<dd class="member"><dl>
<dt>Summary</dt>
<dd>The maximum number of bytes needed to encode any character in the
given encoding.
</dd>
<dt>Description</dt>
<dd>Can be rather meaningless for encodings that encode global state along
with the characters (e.g., ISO-2022 encodings).
</dd>
</dl>
</dd>
</dl>
<hr>
<dl class="member">
<dt class="member"><a name="AverageCharSize"> </a>AverageCharSize</dt>
<dd class="member"><a href="../t-sal_uInt8.html">sal_uInt8</a> <strong>AverageCharSize</strong>;<br>
<br>
</dd>
<dd class="member"><dl>
<dt>Summary</dt>
<dd>The average number of bytes needed to encode a character in the given
encoding.
</dd>
</dl>
</dd>
</dl>
<hr>
<dl class="member">
<dt class="member"><a name="Reserved"> </a>Reserved</dt>
<dd class="member"><a href="../t-sal_uInt8.html">sal_uInt8</a> <strong>Reserved</strong>;<br>
<br>
</dd>
<dd class="member"><dl>
<dt>Summary</dt>
<dd>An unused byte, for padding.
</dd>
</dl>
</dd>
</dl>
<hr>
<dl class="member">
<dt class="member"><a name="Flags"> </a>Flags</dt>
<dd class="member"><a href="../t-sal_uInt32.html">sal_uInt32</a> <strong>Flags</strong>;<br>
<br>
</dd>
<dd class="member"><dl>
<dt>Summary</dt>
<dd>Any combination of the RTL_TEXTENCODING_INFO flags.
</dd>
<dt>Description</dt>
<dd> RTL_TEXTENCODING_INFO_CONTEXT: The encoding uses some mechanism (like
state-changing byte sequences) to switch between different modes (e.g.,
to encode multiple character repertoires within the same byte ranges).
Even if an encoding does not have the CONTEXT property, interpretation
of certain byte values within that encoding can depend on context (e.g.,
a certain byte value could be either a single-byte character or a
subsequent byte of a multi-byte character). Likewise, the single shift
characters (SS2 and SS3) used by some of the EUC encodings (to denote
that the following bytes constitute a character from another character
repertoire) do not imply that encodings making use of these characters
have the CONTEXT property. Examples of encodings that do have the
CONTEXT property are the ISO-2022 encodings and UTF-7.
RTL_TEXTENCODING_INFO_ASCII: The encoding is a superset of ASCII. More
specifically, any appearance of a byte in the range 0x20--7F denotes the
corresponding ASCII character (from SPACE to DELETE); in particular,
such a byte cannot be part of a multi-byte character. Note that the
ASCII control codes 0x00--1F are not included here, as they are used for
special purposes in some encodings.
If an encoding has this property, it is easy to search for occurrences of
ASCII characters within strings of this encoding---you do not need to
keep track whether a byte in the range 0x20--7F really represents an
ASCII character or rather is part of some multi-byte character.
The guarantees when mapping between Unicode and a given encoding with
the ASCII property are as follows: When mapping from Unicode to the
given encoding, U+0020--007F map to 0x20--7F (but there can also be
other Unicode characters mapping into the range 0x20--7F), and when
mapping from the given encoding to Unicode, 0x20--7F map to U+0020--007F
(again, there can also be other characters mapping into the range
U+0020--007F). In particular, this ensures round-trip conversion for
the ASCII range.
In principle, the ASCII property is orthogonal to the CONTEXT property.
In practice, however, an encoding that has the ASCII property will most
likely not also have the CONTEXT property.
RTL_TEXTENCODING_INFO_UNICODE: The encoding is based on the Unicode
character repertoire.
RTL_TEXTENCODING_INFO_MULTIBYTE: A multi-byte encoding.
RTL_TEXTENCODING_INFO_R2L: An encoding used mainly or exclusively for
languages written from right to left.
RTL_TEXTENCODING_INFO_7BIT: A 7-bit instead of an 8-bit encoding.
RTL_TEXTENCODING_INFO_SYMBOL: A (generic) encoding for symbol character
sets.
RTL_TEXTENCODING_INFO_MIME: The encoding is registered as a MIME
charset.
</dd>
</dl>
</dd>
</dl>
<hr>
<a href="#_top_" class="objchapter">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2000, 2012 LibreOffice contributors and/or their affiliates. All rights reserved.</p><p class="copyright" align="center">LibreOffice was created by The Document Foundation, based on OpenOffice.org, which is Copyright 2000, 2010 Oracle and/or its affiliates.</p><p class="copyright" align="center">The Document Foundation acknowledges all community members, please find more info <a href="http://www.libreoffice.org/about-us/credits/" target="_blank">at our website</a>.<p> </p><p class="copyright" align="center"><a href="http://www.libreoffice.org/privacy" target="_blank">Privacy Policy</a> | <a href="http://www.libreoffice.org/imprint" target="_blank">Impressum (Legal Info)</a> | Copyright information: The source code of LibreOffice is licensed under the GNU Lesser General Public License (<a href="http://www.libreoffice.org/download/license/" target="_blank">LGPLv3</a>). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our <a href="http://wiki.documentfoundation.org/TradeMark_Policy" target="_blank">trademark policy</a>.</p>
</div> <!-- id="adc-cppref" -->
</body>
</html>
