blob: 156c58224631e1747085516d1a8a4f37bd927f12 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>Boost.Locale: boost::locale::gnu_gettext::messages_info Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
</head>
<body>
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectlogo"><img alt="Logo" src="boost-small.png"/></td>
<td style="padding-left: 0.5em;">
<div id="projectname">Boost.Locale
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.6.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main&#160;Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class&#160;List</span></a></li>
<li><a href="hierarchy.html"><span>Class&#160;Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class&#160;Members</span></a></li>
</ul>
</div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
initNavTree('structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html','');
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#nested-classes">Classes</a> &#124;
<a href="#pub-types">Public Types</a> &#124;
<a href="#pub-attribs">Public Attributes</a> </div>
<div class="headertitle">
<div class="title">boost::locale::gnu_gettext::messages_info Struct Reference</div> </div>
</div><!--header-->
<div class="contents">
<!-- doxytag: class="boost::locale::gnu_gettext::messages_info" -->
<p>This structure holds all information required for creating gnu-gettext message catalogs,.
<a href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#details">More...</a></p>
<p><code>#include &lt;<a class="el" href="gnu__gettext_8hpp_source.html">boost/locale/gnu_gettext.hpp</a>&gt;</code></p>
<p><a href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="nested-classes"></a>
Classes</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info_1_1domain.html">domain</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">This type represents GNU Gettext domain name for the messages. <a href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info_1_1domain.html#details">More...</a><br/></td></tr>
<tr><td colspan="2"><h2><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef std::vector&lt; <a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info_1_1domain.html">domain</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#ac3bfe22cf949ed3f87ee28fa0c983502">domains_type</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef function&lt; std::vector<br class="typebreak"/>
&lt; char &gt; std::string const <br class="typebreak"/>
&amp;file_name, std::string const <br class="typebreak"/>
&amp;<a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a4a7406581c6c7975c90db9d2d157d384">encoding</a>) &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a4dfe37c5a392e5106e65b396a5288b76">callback_type</a></td></tr>
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Public Attributes</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a1afc3be03d4848042e3208d4ca5aec85"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::language" ref="a1afc3be03d4848042e3208d4ca5aec85" args="" -->
std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a1afc3be03d4848042e3208d4ca5aec85">language</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">The language we load the catalog for, like "ru", "en", "de". <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ae939e0c5dbabba7fb4cc2872f4e7dac2"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::country" ref="ae939e0c5dbabba7fb4cc2872f4e7dac2" args="" -->
std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#ae939e0c5dbabba7fb4cc2872f4e7dac2">country</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">The country we load the catalog for, like "US", "IL". <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="af543a11d3ff1d12e24c06306b30f8fb8"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::variant" ref="af543a11d3ff1d12e24c06306b30f8fb8" args="" -->
std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#af543a11d3ff1d12e24c06306b30f8fb8">variant</a></td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Language variant, like "euro" so it would look for catalog like de_DE@euro. <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a4a7406581c6c7975c90db9d2d157d384">encoding</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a39ea1cfd018c7702d94d03e76042ff10">locale_category</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#ac3bfe22cf949ed3f87ee28fa0c983502">domains_type</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a1ca79b90b4b8dbc924e5eb1b42188311">domains</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">std::vector&lt; std::string &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a263d9d2c359ae7730e6d5bba54bb3022">paths</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a4dfe37c5a392e5106e65b396a5288b76">callback_type</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a63bd8b01ca532a2657186bab3fa396a2">callback</a></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>This structure holds all information required for creating gnu-gettext message catalogs,. </p>
<p>The user is expected to set its parameters to load these catalogs correctly. This structure also allows providing functions for charset conversion. Note, you need to provide them, so this structure is not useful for wide characters without subclassing and it will also ignore gettext catalogs that use a charset different from <em>encoding</em>. </p>
</div><hr/><h2>Member Typedef Documentation</h2>
<a class="anchor" id="a4dfe37c5a392e5106e65b396a5288b76"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::callback_type" ref="a4dfe37c5a392e5106e65b396a5288b76" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef function&lt; std::vector&lt;char&gt; std::string const &amp;file_name, std::string const &amp;<a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a4a7406581c6c7975c90db9d2d157d384">encoding</a> ) &gt; <a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a4dfe37c5a392e5106e65b396a5288b76">boost::locale::gnu_gettext::messages_info::callback_type</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The callback for custom file system support. This callback should read the file named <em>file_name</em> encoded in <em>encoding</em> character set into std::vector&lt;char&gt; and return it.</p>
<ul>
<li>If the file does not exist, it should return an empty vector.</li>
<li>If a error occurs during file read it should throw a error.</li>
</ul>
<dl class="note"><dt><b>Note:</b></dt><dd>The user should support only the encodings the locales are created for. So if the user uses only one encoding or the file system is encoding agnostic, he may ignore the <em>encoding</em> parameter. </dd></dl>
</div>
</div>
<a class="anchor" id="ac3bfe22cf949ed3f87ee28fa0c983502"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::domains_type" ref="ac3bfe22cf949ed3f87ee28fa0c983502" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef std::vector&lt;<a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info_1_1domain.html">domain</a>&gt; <a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#ac3bfe22cf949ed3f87ee28fa0c983502">boost::locale::gnu_gettext::messages_info::domains_type</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Type that defines a list of domains that are loaded The first one is the default one </p>
</div>
</div>
<hr/><h2>Member Data Documentation</h2>
<a class="anchor" id="a63bd8b01ca532a2657186bab3fa396a2"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::callback" ref="a63bd8b01ca532a2657186bab3fa396a2" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a4dfe37c5a392e5106e65b396a5288b76">callback_type</a> <a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a63bd8b01ca532a2657186bab3fa396a2">boost::locale::gnu_gettext::messages_info::callback</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The callback for handling custom file systems, if it is empty, the real OS file-system is being used. </p>
</div>
</div>
<a class="anchor" id="a1ca79b90b4b8dbc924e5eb1b42188311"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::domains" ref="a1ca79b90b4b8dbc924e5eb1b42188311" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#ac3bfe22cf949ed3f87ee28fa0c983502">domains_type</a> <a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a1ca79b90b4b8dbc924e5eb1b42188311">boost::locale::gnu_gettext::messages_info::domains</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Message domains - application name, like my_app. So files named my_app.mo would be loaded </p>
</div>
</div>
<a class="anchor" id="a4a7406581c6c7975c90db9d2d157d384"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::encoding" ref="a4a7406581c6c7975c90db9d2d157d384" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string <a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a4a7406581c6c7975c90db9d2d157d384">boost::locale::gnu_gettext::messages_info::encoding</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Required target charset encoding. Ignored for wide characters. For narrow, should specify the correct encoding required for this catalog </p>
</div>
</div>
<a class="anchor" id="a39ea1cfd018c7702d94d03e76042ff10"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::locale_category" ref="a39ea1cfd018c7702d94d03e76042ff10" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string <a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a39ea1cfd018c7702d94d03e76042ff10">boost::locale::gnu_gettext::messages_info::locale_category</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Locale category, is set by default to LC_MESSAGES, but may be changed </p>
</div>
</div>
<a class="anchor" id="a263d9d2c359ae7730e6d5bba54bb3022"></a><!-- doxytag: member="boost::locale::gnu_gettext::messages_info::paths" ref="a263d9d2c359ae7730e6d5bba54bb3022" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::vector&lt;std::string&gt; <a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html#a263d9d2c359ae7730e6d5bba54bb3022">boost::locale::gnu_gettext::messages_info::paths</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Paths to search files in. Under MS Windows it uses encoding parameter to convert them to wide OS specific paths. </p>
</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li>boost/locale/<a class="el" href="gnu__gettext_8hpp_source.html">gnu_gettext.hpp</a></li>
</ul>
</div><!-- contents -->
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><b>boost</b> </li>
<li class="navelem"><a class="el" href="namespaceboost_1_1locale.html">locale</a> </li>
<li class="navelem"><a class="el" href="namespaceboost_1_1locale_1_1gnu__gettext.html">gnu_gettext</a> </li>
<li class="navelem"><a class="el" href="structboost_1_1locale_1_1gnu__gettext_1_1messages__info.html">messages_info</a> </li>
<li class="footer">
&copy; Copyright 2009-2012 Artyom Beilis, Distributed under the <a href="http://www.boost.org/LICENSE_1_0.txt">Boost Software License</a>, Version 1.0.
</li>
</ul>
</div>
</body>
</html>