doc/classes/GetText.html in gettext-1.91.0 vs doc/classes/GetText.html in gettext-1.92.0

- old
+ new

@@ -142,47 +142,50 @@ <div id="method-list"> <h3 class="section-bar">Methods</h3> <div class="name-list"> - <a href="#M000037">N_</a>&nbsp;&nbsp; - <a href="#M000038">Nn_</a>&nbsp;&nbsp; - <a href="#M000051">_</a>&nbsp;&nbsp; - <a href="#M000047">add_default_locale_path</a>&nbsp;&nbsp; - <a href="#M000030">bindtextdomain</a>&nbsp;&nbsp; - <a href="#M000031">bindtextdomain_to</a>&nbsp;&nbsp; - <a href="#M000027">cached=</a>&nbsp;&nbsp; - <a href="#M000028">cached?</a>&nbsp;&nbsp; - <a href="#M000025">cgi</a>&nbsp;&nbsp; - <a href="#M000024">cgi=</a>&nbsp;&nbsp; - <a href="#M000029">clear_cache</a>&nbsp;&nbsp; - <a href="#M000019">create_mofiles</a>&nbsp;&nbsp; - <a href="#M000048">current_textdomain_info</a>&nbsp;&nbsp; - <a href="#M000034">gettext</a>&nbsp;&nbsp; - <a href="#M000046">locale</a>&nbsp;&nbsp; - <a href="#M000042">locale=</a>&nbsp;&nbsp; - <a href="#M000018">msgmerge</a>&nbsp;&nbsp; - <a href="#M000052">n_</a>&nbsp;&nbsp; - <a href="#M000036">ngettext</a>&nbsp;&nbsp; - <a href="#M000054">ns_</a>&nbsp;&nbsp; - <a href="#M000039">nsgettext</a>&nbsp;&nbsp; - <a href="#M000045">output_charset</a>&nbsp;&nbsp; - <a href="#M000044">output_charset=</a>&nbsp;&nbsp; - <a href="#M000049">remove_all_textdomains</a>&nbsp;&nbsp; - <a href="#M000021">rgettext</a>&nbsp;&nbsp; - <a href="#M000022">rmsgfmt</a>&nbsp;&nbsp; - <a href="#M000026">rmsgmerge</a>&nbsp;&nbsp; - <a href="#M000053">s_</a>&nbsp;&nbsp; - <a href="#M000023">set_cgi</a>&nbsp;&nbsp; - <a href="#M000040">set_locale</a>&nbsp;&nbsp; - <a href="#M000041">set_locale_all</a>&nbsp;&nbsp; - <a href="#M000043">set_output_charset</a>&nbsp;&nbsp; - <a href="#M000050">setlocale</a>&nbsp;&nbsp; - <a href="#M000035">sgettext</a>&nbsp;&nbsp; - <a href="#M000032">textdomain</a>&nbsp;&nbsp; - <a href="#M000033">textdomain_to</a>&nbsp;&nbsp; - <a href="#M000020">update_pofiles</a>&nbsp;&nbsp; + <a href="#M000092">N_</a>&nbsp;&nbsp; + <a href="#M000093">Nn_</a>&nbsp;&nbsp; + <a href="#M000106">_</a>&nbsp;&nbsp; + <a href="#M000102">add_default_locale_path</a>&nbsp;&nbsp; + <a href="#M000083">bindtextdomain</a>&nbsp;&nbsp; + <a href="#M000084">bindtextdomain_to</a>&nbsp;&nbsp; + <a href="#M000080">cached=</a>&nbsp;&nbsp; + <a href="#M000081">cached?</a>&nbsp;&nbsp; + <a href="#M000078">cgi</a>&nbsp;&nbsp; + <a href="#M000077">cgi=</a>&nbsp;&nbsp; + <a href="#M000082">clear_cache</a>&nbsp;&nbsp; + <a href="#M000072">create_mofiles</a>&nbsp;&nbsp; + <a href="#M000103">current_textdomain_info</a>&nbsp;&nbsp; + <a href="#M000087">gettext</a>&nbsp;&nbsp; + <a href="#M000101">locale</a>&nbsp;&nbsp; + <a href="#M000097">locale=</a>&nbsp;&nbsp; + <a href="#M000071">msgmerge</a>&nbsp;&nbsp; + <a href="#M000107">n_</a>&nbsp;&nbsp; + <a href="#M000090">ngettext</a>&nbsp;&nbsp; + <a href="#M000091">npgettext</a>&nbsp;&nbsp; + <a href="#M000110">ns_</a>&nbsp;&nbsp; + <a href="#M000094">nsgettext</a>&nbsp;&nbsp; + <a href="#M000100">output_charset</a>&nbsp;&nbsp; + <a href="#M000099">output_charset=</a>&nbsp;&nbsp; + <a href="#M000109">p_</a>&nbsp;&nbsp; + <a href="#M000089">pgettext</a>&nbsp;&nbsp; + <a href="#M000104">remove_all_textdomains</a>&nbsp;&nbsp; + <a href="#M000074">rgettext</a>&nbsp;&nbsp; + <a href="#M000075">rmsgfmt</a>&nbsp;&nbsp; + <a href="#M000079">rmsgmerge</a>&nbsp;&nbsp; + <a href="#M000108">s_</a>&nbsp;&nbsp; + <a href="#M000076">set_cgi</a>&nbsp;&nbsp; + <a href="#M000095">set_locale</a>&nbsp;&nbsp; + <a href="#M000096">set_locale_all</a>&nbsp;&nbsp; + <a href="#M000098">set_output_charset</a>&nbsp;&nbsp; + <a href="#M000105">setlocale</a>&nbsp;&nbsp; + <a href="#M000088">sgettext</a>&nbsp;&nbsp; + <a href="#M000085">textdomain</a>&nbsp;&nbsp; + <a href="#M000086">textdomain_to</a>&nbsp;&nbsp; + <a href="#M000073">update_pofiles</a>&nbsp;&nbsp; </div> </div> </div> @@ -222,11 +225,11 @@ <div class="name-list"> <table summary="Constants"> <tr class="top-aligned-row context-row"> <td class="context-item-name">VERSION</td> <td>=</td> - <td class="context-item-value">&quot;1.91.0&quot;</td> + <td class="context-item-value">&quot;1.92.0&quot;</td> </tr> </table> </div> </div> @@ -237,58 +240,58 @@ <!-- if method_list --> <div id="methods"> <h3 class="section-bar">Public Instance methods</h3> - <div id="method-M000037" class="method-detail"> - <a name="M000037"></a> + <div id="method-M000092" class="method-detail"> + <a name="M000092"></a> <div class="method-heading"> - <a href="#M000037" class="method-signature"> + <a href="#M000092" class="method-signature"> <span class="method-name">N_</span><span class="method-args">(msgid)</span> </a> </div> <div class="method-description"> <p> This function does nothing. But it is required in order to recognize the -msgid by <a href="GetText.html#M000021">rgettext</a>. +msgid by <a href="GetText.html#M000074">rgettext</a>. </p> <ul> <li>msgid: the message id. </li> <li>Returns: msgid. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000037-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000037-source"> + onclick="toggleCode('M000092-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000092-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 329</span> -329: <span class="ruby-keyword kw">def</span> <span class="ruby-constant">N_</span>(<span class="ruby-identifier">msgid</span>) -330: <span class="ruby-identifier">msgid</span> -331: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 369</span> +369: <span class="ruby-keyword kw">def</span> <span class="ruby-constant">N_</span>(<span class="ruby-identifier">msgid</span>) +370: <span class="ruby-identifier">msgid</span> +371: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000038" class="method-detail"> - <a name="M000038"></a> + <div id="method-M000093" class="method-detail"> + <a name="M000093"></a> <div class="method-heading"> - <a href="#M000038" class="method-signature"> + <a href="#M000093" class="method-signature"> <span class="method-name">Nn_</span><span class="method-args">(msgid, msgid_plural)</span> </a> </div> <div class="method-description"> <p> -This is same function as <a href="GetText.html#M000037">N_</a> but for <a -href="GetText.html#M000036">ngettext</a>. +This is same function as <a href="GetText.html#M000092">N_</a> but for <a +href="GetText.html#M000090">ngettext</a>. </p> <ul> <li>msgid: the message id. </li> @@ -298,118 +301,118 @@ <li>Returns: msgid. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000038-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000038-source"> + onclick="toggleCode('M000093-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000093-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 337</span> -337: <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Nn_</span>(<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">msgid_plural</span>) -338: [<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">msgid_plural</span>] -339: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 377</span> +377: <span class="ruby-keyword kw">def</span> <span class="ruby-constant">Nn_</span>(<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">msgid_plural</span>) +378: [<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">msgid_plural</span>] +379: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000051" class="method-detail"> - <a name="M000051"></a> + <div id="method-M000106" class="method-detail"> + <a name="M000106"></a> <div class="method-heading"> <span class="method-name">_</span><span class="method-args">(msgid)</span> </div> <div class="method-description"> <p> -Alias for <a href="GetText.html#M000034">gettext</a> +Alias for <a href="GetText.html#M000087">gettext</a> </p> </div> </div> - <div id="method-M000047" class="method-detail"> - <a name="M000047"></a> + <div id="method-M000102" class="method-detail"> + <a name="M000102"></a> <div class="method-heading"> - <a href="#M000047" class="method-signature"> + <a href="#M000102" class="method-signature"> <span class="method-name">add_default_locale_path</span><span class="method-args">(path)</span> </a> </div> <div class="method-description"> <p> -Add default <a href="GetText.html#M000046">locale</a> path. +Add default <a href="GetText.html#M000101">locale</a> path. </p> <ul> -<li>path: a new <a href="GetText.html#M000046">locale</a> path. (e.g.) +<li>path: a new <a href="GetText.html#M000101">locale</a> path. (e.g.) &quot;/usr/share/locale/%{<a -href="GetText.html#M000046">locale</a>}/LC_MESSAGES/%{name}.mo&quot; -(&#8216;<a href="GetText.html#M000046">locale</a>&#8217; =&gt; +href="GetText.html#M000101">locale</a>}/LC_MESSAGES/%{name}.mo&quot; +(&#8216;<a href="GetText.html#M000101">locale</a>&#8217; =&gt; &quot;ja_JP&quot;, &#8216;name&#8217; =&gt; &quot;<a -href="GetText.html#M000032">textdomain</a>&quot;) +href="GetText.html#M000085">textdomain</a>&quot;) </li> <li>Returns: the new DEFAULT_LOCALE_PATHS </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000047-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000047-source"> + onclick="toggleCode('M000102-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000102-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 511</span> -511: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_default_locale_path</span>(<span class="ruby-identifier">path</span>) -512: <span class="ruby-constant">TextDomain</span>.<span class="ruby-identifier">add_default_locale_path</span>(<span class="ruby-identifier">path</span>) -513: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 551</span> +551: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_default_locale_path</span>(<span class="ruby-identifier">path</span>) +552: <span class="ruby-constant">TextDomain</span>.<span class="ruby-identifier">add_default_locale_path</span>(<span class="ruby-identifier">path</span>) +553: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000030" class="method-detail"> - <a name="M000030"></a> + <div id="method-M000083" class="method-detail"> + <a name="M000083"></a> <div class="method-heading"> - <a href="#M000030" class="method-signature"> + <a href="#M000083" class="method-signature"> <span class="method-name">bindtextdomain(domainname, options = {})<br /> </span> </a> </div> <div class="method-description"> <p> -Bind a <a href="GetText.html#M000032">textdomain</a>(%{path}/%{<a -href="GetText.html#M000046">locale</a>}/LC_MESSAGES/%{domainname}.mo) to +Bind a <a href="GetText.html#M000085">textdomain</a>(%{path}/%{<a +href="GetText.html#M000101">locale</a>}/LC_MESSAGES/%{domainname}.mo) to your program. Normally, the texdomain scope becomes a ruby-script-file. So you need to call this function each ruby-script-files. On the other hand, if you call this function under <a href="GetText/Container.html">GetText::Container</a> (gettext/container, gettext/erb, gettext/rails), the <a -href="GetText.html#M000032">textdomain</a> scope becomes a Class/<a +href="GetText.html#M000085">textdomain</a> scope becomes a Class/<a href="Module.html">Module</a>. </p> <ul> -<li>domainname: the <a href="GetText.html#M000032">textdomain</a> name. +<li>domainname: the <a href="GetText.html#M000085">textdomain</a> name. </li> <li>options: options as an Hash. <ul> <li>:path - the path to the mo-files. When the value is nil, it will search default paths such as /usr/share/locale, /usr/local/share/locale) </li> -<li>:<a href="GetText.html#M000046">locale</a> - the <a -href="GetText.html#M000046">locale</a> string such as +<li>:<a href="GetText.html#M000101">locale</a> - the <a +href="GetText.html#M000101">locale</a> string such as &quot;ja_JP.UTF-8&quot;. Generally, you should use <a -href="GetText.html#M000040">GetText.set_locale</a> instead. The value is +href="GetText.html#M000095">GetText.set_locale</a> instead. The value is searched order by: the value of this value &gt; System default language. </li> <li>:charset - output charset. This affect the current <a -href="GetText.html#M000032">textdomain</a> only. Generally, you should use -<a href="GetText.html#M000043">GetText.set_output_charset</a> instead. The +href="GetText.html#M000085">textdomain</a> only. Generally, you should use +<a href="GetText.html#M000098">GetText.set_output_charset</a> instead. The value is searched order by: the value of Locale.set_output_charset &gt; ENV[&quot;OUTPUT_CHARSET&quot;] &gt; this value &gt; System default charset. </li> @@ -423,12 +426,12 @@ <p> Note: Don&#8216;t use locale_, charset argument(not in options). They are remained for backward compatibility. </p> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000030-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000030-source"> + onclick="toggleCode('M000083-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000083-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext.rb, line 85</span> 85: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">bindtextdomain</span>(<span class="ruby-identifier">domainname</span>, <span class="ruby-identifier">options</span> = {}, <span class="ruby-identifier">locale_</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">charset</span> = <span class="ruby-keyword kw">nil</span>) 86: <span class="ruby-identifier">opt</span> = {} 87: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">options</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">String</span> @@ -455,39 +458,39 @@ </pre> </div> </div> </div> - <div id="method-M000031" class="method-detail"> - <a name="M000031"></a> + <div id="method-M000084" class="method-detail"> + <a name="M000084"></a> <div class="method-heading"> - <a href="#M000031" class="method-signature"> + <a href="#M000084" class="method-signature"> <span class="method-name">bindtextdomain_to</span><span class="method-args">(klass, domainname, options = {})</span> </a> </div> <div class="method-description"> <p> Includes <a href="GetText.html">GetText</a> module and bind a <a -href="GetText.html#M000032">textdomain</a> to a class. +href="GetText.html#M000085">textdomain</a> to a class. </p> <ul> <li>klass: the target ruby class. </li> -<li>domainname: the <a href="GetText.html#M000032">textdomain</a> name. +<li>domainname: the <a href="GetText.html#M000085">textdomain</a> name. </li> <li>options: options as an Hash. See <a -href="GetText.html#M000030">GetText.bindtextdomain</a>. +href="GetText.html#M000083">GetText.bindtextdomain</a>. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000031-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000031-source"> + onclick="toggleCode('M000084-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000084-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext.rb, line 113</span> 113: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">bindtextdomain_to</span>(<span class="ruby-identifier">klass</span>, <span class="ruby-identifier">domainname</span>, <span class="ruby-identifier">options</span> = {}) 114: <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">nil</span> 115: <span class="ruby-identifier">klass</span>.<span class="ruby-identifier">module_eval</span> { @@ -499,15 +502,15 @@ </pre> </div> </div> </div> - <div id="method-M000027" class="method-detail"> - <a name="M000027"></a> + <div id="method-M000080" class="method-detail"> + <a name="M000080"></a> <div class="method-heading"> - <a href="#M000027" class="method-signature"> + <a href="#M000080" class="method-signature"> <span class="method-name">cached=</span><span class="method-args">(val)</span> </a> </div> <div class="method-description"> @@ -518,12 +521,12 @@ <p> Default is true. If $DEBUG is false, messages are not checked even if this value is true. </p> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000027-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000027-source"> + onclick="toggleCode('M000080-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000080-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext.rb, line 42</span> 42: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cached=</span>(<span class="ruby-identifier">val</span>) 43: <span class="ruby-ivar">@@__cached</span> = <span class="ruby-identifier">val</span> 44: <span class="ruby-constant">GetText</span><span class="ruby-operator">::</span><span class="ruby-constant">TextDomain</span>.<span class="ruby-identifier">check_mo</span> = <span class="ruby-operator">!</span> <span class="ruby-identifier">val</span> @@ -531,41 +534,41 @@ </pre> </div> </div> </div> - <div id="method-M000028" class="method-detail"> - <a name="M000028"></a> + <div id="method-M000081" class="method-detail"> + <a name="M000081"></a> <div class="method-heading"> - <a href="#M000028" class="method-signature"> + <a href="#M000081" class="method-signature"> <span class="method-name">cached?</span><span class="method-args">()</span> </a> </div> <div class="method-description"> <p> Return the cached value. </p> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000028-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000028-source"> + onclick="toggleCode('M000081-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000081-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext.rb, line 48</span> 48: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cached?</span> 49: <span class="ruby-ivar">@@__cached</span> 50: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000025" class="method-detail"> - <a name="M000025"></a> + <div id="method-M000078" class="method-detail"> + <a name="M000078"></a> <div class="method-heading"> - <a href="#M000025" class="method-signature"> + <a href="#M000078" class="method-signature"> <span class="method-name">cgi</span><span class="method-args">()</span> </a> </div> <div class="method-description"> @@ -576,46 +579,46 @@ <li>Returns: the CGI object </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000025-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000025-source"> + onclick="toggleCode('M000078-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000078-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext/cgi.rb, line 36</span> 36: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cgi</span> 37: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">cgi</span> 38: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000024" class="method-detail"> - <a name="M000024"></a> + <div id="method-M000077" class="method-detail"> + <a name="M000077"></a> <div class="method-heading"> - <a href="#M000024" class="method-signature"> + <a href="#M000077" class="method-signature"> <span class="method-name">cgi=</span><span class="method-args">(cgi_)</span> </a> </div> <div class="method-description"> <p> -Same as <a href="GetText.html#M000023">GetText.set_cgi</a>. +Same as <a href="GetText.html#M000076">GetText.set_cgi</a>. </p> <ul> <li>cgi_: CGI object </li> <li>Returns: cgi_ </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000024-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000024-source"> + onclick="toggleCode('M000077-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000077-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext/cgi.rb, line 29</span> 29: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">cgi=</span>(<span class="ruby-identifier">cgi_</span>) 30: <span class="ruby-identifier">set_cgi</span>(<span class="ruby-identifier">cgi_</span>) 31: <span class="ruby-identifier">cgi_</span> @@ -623,26 +626,26 @@ </pre> </div> </div> </div> - <div id="method-M000029" class="method-detail"> - <a name="M000029"></a> + <div id="method-M000082" class="method-detail"> + <a name="M000082"></a> <div class="method-heading"> - <a href="#M000029" class="method-signature"> + <a href="#M000082" class="method-signature"> <span class="method-name">clear_cache</span><span class="method-args">()</span> </a> </div> <div class="method-description"> <p> Clear the cached messages. </p> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000029-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000029-source"> + onclick="toggleCode('M000082-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000082-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext.rb, line 53</span> 53: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">clear_cache</span> 54: <span class="ruby-ivar">@@__cache_msgids</span> = {} 55: <span class="ruby-ivar">@@__cache_nmsgids</span> = {} @@ -653,15 +656,15 @@ </pre> </div> </div> </div> - <div id="method-M000019" class="method-detail"> - <a name="M000019"></a> + <div id="method-M000072" class="method-detail"> + <a name="M000072"></a> <div class="method-heading"> - <a href="#M000019" class="method-signature"> + <a href="#M000072" class="method-signature"> <span class="method-name">create_mofiles</span><span class="method-args">(verbose = false, podir = &quot;./po&quot;, targetdir = &quot;./data/locale&quot;, targetpath_rule = &quot;%s/LC_MESSAGES&quot;)</span> </a> </div> <div class="method-description"> @@ -669,11 +672,11 @@ Creates mo-files using #{po_root}/#{lang}/*.po an put them to #{targetdir}/#{targetpath_rule}/. </p> <p> This is a convenience function of <a -href="GetText.html#M000022">GetText.rmsgfmt</a> for plural target files. +href="GetText.html#M000075">GetText.rmsgfmt</a> for plural target files. </p> <ul> <li>verbose: true if verbose mode, otherwise false </li> @@ -687,12 +690,12 @@ becomes &quot;#{lang}&quot; under po_root. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000019-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000019-source"> + onclick="toggleCode('M000072-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000072-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext/utils.rb, line 96</span> 96: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">create_mofiles</span>(<span class="ruby-identifier">verbose</span> = <span class="ruby-keyword kw">false</span>, 97: <span class="ruby-identifier">podir</span> = <span class="ruby-value str">&quot;./po&quot;</span>, <span class="ruby-identifier">targetdir</span> = <span class="ruby-value str">&quot;./data/locale&quot;</span>, 98: <span class="ruby-identifier">targetpath_rule</span> = <span class="ruby-value str">&quot;%s/LC_MESSAGES&quot;</span>) @@ -700,33 +703,37 @@ 100: <span class="ruby-identifier">modir</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">targetdir</span>, <span class="ruby-identifier">targetpath_rule</span>) 101: <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">glob</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">podir</span>, <span class="ruby-value str">&quot;*/*.po&quot;</span>)) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span> 102: <span class="ruby-identifier">lang</span>, <span class="ruby-identifier">basename</span> = <span class="ruby-regexp re">/\/([^\/]+?)\/(.*)\.po/</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">file</span>[<span class="ruby-identifier">podir</span>.<span class="ruby-identifier">size</span><span class="ruby-operator">..</span><span class="ruby-value">-1</span>]).<span class="ruby-identifier">to_a</span>[<span class="ruby-value">1</span>,<span class="ruby-value">2</span>] 103: <span class="ruby-identifier">outdir</span> = <span class="ruby-identifier">modir</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">lang</span> 104: <span class="ruby-constant">FileUtils</span>.<span class="ruby-identifier">mkdir_p</span>(<span class="ruby-identifier">outdir</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">outdir</span>) -105: <span class="ruby-identifier">rmsgfmt</span>(<span class="ruby-identifier">file</span>, <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">outdir</span>, <span class="ruby-node">&quot;#{basename}.mo&quot;</span>)) -106: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">verbose</span> -107: <span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-node">%Q[#{file} -&gt; #{File.join(outdir, &quot;#{basename}.mo&quot;)}]</span> -108: <span class="ruby-keyword kw">end</span> -109: <span class="ruby-keyword kw">end</span> -110: <span class="ruby-keyword kw">end</span> +105: <span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">print</span> <span class="ruby-node">%Q[#{file} -&gt; #{File.join(outdir, &quot;#{basename}.mo&quot;)} ... ]</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">verbose</span> +106: <span class="ruby-keyword kw">begin</span> +107: <span class="ruby-identifier">rmsgfmt</span>(<span class="ruby-identifier">file</span>, <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">outdir</span>, <span class="ruby-node">&quot;#{basename}.mo&quot;</span>)) +108: <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span> +109: <span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Error.&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">verbose</span> +110: <span class="ruby-identifier">raise</span> <span class="ruby-identifier">e</span> +111: <span class="ruby-keyword kw">end</span> +112: <span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Done.&quot;</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">verbose</span> +113: <span class="ruby-keyword kw">end</span> +114: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000048" class="method-detail"> - <a name="M000048"></a> + <div id="method-M000103" class="method-detail"> + <a name="M000103"></a> <div class="method-heading"> - <a href="#M000048" class="method-signature"> + <a href="#M000103" class="method-signature"> <span class="method-name">current_textdomain_info</span><span class="method-args">(options = {})</span> </a> </div> <div class="method-description"> <p> -Show the current <a href="GetText.html#M000032">textdomain</a> information. +Show the current <a href="GetText.html#M000085">textdomain</a> information. This function is for debugging. </p> <ul> <li>options: options as a Hash. @@ -743,45 +750,45 @@ </li> </ul> </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000048-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000048-source"> + onclick="toggleCode('M000103-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000103-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 520</span> -520: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">current_textdomain_info</span>(<span class="ruby-identifier">options</span> = {}) -521: <span class="ruby-identifier">opts</span> = {<span class="ruby-identifier">:with_messages</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">false</span>, <span class="ruby-identifier">:with_paths</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">false</span>, <span class="ruby-identifier">:out</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">STDOUT</span>}.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">options</span>) -522: <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">nil</span> -523: <span class="ruby-identifier">each_textdomain</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">textdomain</span><span class="ruby-operator">|</span> -524: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;TextDomain name: \&quot;#{textdomain.name}\&quot;&quot;</span> -525: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;TextDomain current locale: \&quot;#{textdomain.current_locale}\&quot;&quot;</span> -526: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;TextDomain current mo filename: \&quot;#{textdomain.current_mo.filename}\&quot;&quot;</span> -527: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:with_paths</span>] -528: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;TextDomain locale file paths:&quot;</span> -529: <span class="ruby-identifier">textdomain</span>.<span class="ruby-identifier">locale_paths</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span> -530: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot; #{v}&quot;</span> -531: <span class="ruby-keyword kw">end</span> -532: <span class="ruby-keyword kw">end</span> -533: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:with_messages</span>] -534: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;The messages in the mo file:&quot;</span> -535: <span class="ruby-identifier">textdomain</span>.<span class="ruby-identifier">current_mo</span>.<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span><span class="ruby-operator">|</span> -536: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot; \&quot;#{k}\&quot;: \&quot;#{v}\&quot;&quot;</span> -537: } -538: <span class="ruby-keyword kw">end</span> -539: } -540: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 560</span> +560: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">current_textdomain_info</span>(<span class="ruby-identifier">options</span> = {}) +561: <span class="ruby-identifier">opts</span> = {<span class="ruby-identifier">:with_messages</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">false</span>, <span class="ruby-identifier">:with_paths</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword kw">false</span>, <span class="ruby-identifier">:out</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">STDOUT</span>}.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">options</span>) +562: <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">nil</span> +563: <span class="ruby-identifier">each_textdomain</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">textdomain</span><span class="ruby-operator">|</span> +564: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;TextDomain name: \&quot;#{textdomain.name}\&quot;&quot;</span> +565: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;TextDomain current locale: \&quot;#{textdomain.current_locale}\&quot;&quot;</span> +566: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;TextDomain current mo filename: \&quot;#{textdomain.current_mo.filename}\&quot;&quot;</span> +567: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:with_paths</span>] +568: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;TextDomain locale file paths:&quot;</span> +569: <span class="ruby-identifier">textdomain</span>.<span class="ruby-identifier">locale_paths</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">v</span><span class="ruby-operator">|</span> +570: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot; #{v}&quot;</span> +571: <span class="ruby-keyword kw">end</span> +572: <span class="ruby-keyword kw">end</span> +573: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:with_messages</span>] +574: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;The messages in the mo file:&quot;</span> +575: <span class="ruby-identifier">textdomain</span>.<span class="ruby-identifier">current_mo</span>.<span class="ruby-identifier">each</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span><span class="ruby-operator">|</span> +576: <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:out</span>].<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot; \&quot;#{k}\&quot;: \&quot;#{v}\&quot;&quot;</span> +577: } +578: <span class="ruby-keyword kw">end</span> +579: } +580: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000034" class="method-detail"> - <a name="M000034"></a> + <div id="method-M000087" class="method-detail"> + <a name="M000087"></a> <div class="method-heading"> - <a href="#M000034" class="method-signature"> + <a href="#M000087" class="method-signature"> <span class="method-name">gettext(msgid)<br /> _(msgid)<br /> </span> </a> </div> @@ -794,18 +801,18 @@ <p> You need to use String#dup if you want to modify the return value with destructive functions. </p> <p> -(e.g.1) <a href="GetText.html#M000051">_</a>(&quot;Hello &quot;).dup +(e.g.1) <a href="GetText.html#M000106">_</a>(&quot;Hello &quot;).dup &lt;&lt; &quot;world&quot; </p> <p> But e.g.1 should be rewrite to: </p> <p> -(e.g.2) <a href="GetText.html#M000051">_</a>(&quot;Hello %{val}&quot;) % +(e.g.2) <a href="GetText.html#M000106">_</a>(&quot;Hello %{val}&quot;) % {:val =&gt; &quot;world&quot;} </p> <p> Because the translator may want to change the position of &quot;world&quot;. @@ -818,112 +825,112 @@ return msgid. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000034-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000034-source"> + onclick="toggleCode('M000087-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000087-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 262</span> -262: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">gettext</span>(<span class="ruby-identifier">msgid</span>) -263: <span class="ruby-identifier">sgettext</span>(<span class="ruby-identifier">msgid</span>, <span class="ruby-keyword kw">nil</span>) -264: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 263</span> +263: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">gettext</span>(<span class="ruby-identifier">msgid</span>) +264: <span class="ruby-identifier">sgettext</span>(<span class="ruby-identifier">msgid</span>, <span class="ruby-keyword kw">nil</span>) +265: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000046" class="method-detail"> - <a name="M000046"></a> + <div id="method-M000101" class="method-detail"> + <a name="M000101"></a> <div class="method-heading"> - <a href="#M000046" class="method-signature"> + <a href="#M000101" class="method-signature"> <span class="method-name">locale</span><span class="method-args">()</span> </a> </div> <div class="method-description"> <p> -Gets the current <a href="GetText.html#M000046">locale</a>. +Gets the current <a href="GetText.html#M000101">locale</a>. </p> <ul> <li>Returns: a current <a href="Locale/Object.html">Locale::Object</a> </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000046-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000046-source"> + onclick="toggleCode('M000101-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000101-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 503</span> -503: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">locale</span> -504: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">current</span> -505: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 543</span> +543: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">locale</span> +544: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">current</span> +545: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000042" class="method-detail"> - <a name="M000042"></a> + <div id="method-M000097" class="method-detail"> + <a name="M000097"></a> <div class="method-heading"> - <a href="#M000042" class="method-signature"> + <a href="#M000097" class="method-signature"> <span class="method-name">locale=</span><span class="method-args">(locale)</span> </a> </div> <div class="method-description"> <p> -Sets the default/current <a href="GetText.html#M000046">locale</a>. This +Sets the default/current <a href="GetText.html#M000101">locale</a>. This method haves the strongest infulence. All of the Textdomains are set the -new <a href="GetText.html#M000046">locale</a>. +new <a href="GetText.html#M000101">locale</a>. </p> <p> Note that you shouldn&#8216;t use this for your own Libraries. </p> <ul> -<li><a href="GetText.html#M000046">locale</a>: a <a -href="GetText.html#M000046">locale</a> string or <a +<li><a href="GetText.html#M000101">locale</a>: a <a +href="GetText.html#M000101">locale</a> string or <a href="Locale/Object.html">Locale::Object</a> </li> -<li>Returns: a <a href="GetText.html#M000046">locale</a> string +<li>Returns: a <a href="GetText.html#M000101">locale</a> string </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000042-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000042-source"> + onclick="toggleCode('M000097-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000097-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 473</span> -473: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">locale=</span>(<span class="ruby-identifier">locale</span>) -474: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">default</span> = <span class="ruby-identifier">locale</span> -475: <span class="ruby-identifier">set_locale_all</span>(<span class="ruby-identifier">locale</span>) -476: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">default</span> -477: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 513</span> +513: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">locale=</span>(<span class="ruby-identifier">locale</span>) +514: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">default</span> = <span class="ruby-identifier">locale</span> +515: <span class="ruby-identifier">set_locale_all</span>(<span class="ruby-identifier">locale</span>) +516: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">default</span> +517: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000018" class="method-detail"> - <a name="M000018"></a> + <div id="method-M000071" class="method-detail"> + <a name="M000071"></a> <div class="method-heading"> - <a href="#M000018" class="method-signature"> + <a href="#M000071" class="method-signature"> <span class="method-name">msgmerge</span><span class="method-args">(defpo, refpo, app_version)</span> </a> </div> <div class="method-description"> <p> Merges two Uniforum style .po files together. </p> <p> <b>Note</b> This function requires &quot;<a -href="GetText.html#M000018">msgmerge</a>&quot; tool included in GNU <a +href="GetText.html#M000071">msgmerge</a>&quot; tool included in GNU <a href="GetText.html">GetText</a>. So you need to install GNU <a href="GetText.html">GetText</a>. </p> <p> The def.po file is an existing PO file with translations which will be @@ -932,18 +939,18 @@ discarded. </p> <p> The ref.pot file is the last created PO file with up-to-date source references but old translations, or a PO Template file (generally created -by <a href="GetText.html#M000021">rgettext</a>); any translations or +by <a href="GetText.html#M000074">rgettext</a>); any translations or comments in the file will be discarded, however dot comments and file positions will be preserved. Where an exact match cannot be found, fuzzy matching is used to produce better results. </p> <p> Usually you don&#8216;t need to call this function directly. Use <a -href="GetText.html#M000020">GetText.update_pofiles</a> instead. +href="GetText.html#M000073">GetText.update_pofiles</a> instead. </p> <ul> <li>defpo: a po-file. translations referring to old sources </li> @@ -957,12 +964,12 @@ <li>Returns: self </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000018-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000018-source"> + onclick="toggleCode('M000071-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000071-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext/utils.rb, line 47</span> 47: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">msgmerge</span>(<span class="ruby-identifier">defpo</span>, <span class="ruby-identifier">refpo</span>, <span class="ruby-identifier">app_version</span>) 48: <span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-identifier">defpo</span> 49: <span class="ruby-identifier">cmd</span> = <span class="ruby-constant">ENV</span>[<span class="ruby-value str">&quot;MSGMERGE_PATH&quot;</span>] <span class="ruby-operator">||</span> <span class="ruby-value str">&quot;msgmerge&quot;</span> @@ -996,41 +1003,41 @@ </pre> </div> </div> </div> - <div id="method-M000052" class="method-detail"> - <a name="M000052"></a> + <div id="method-M000107" class="method-detail"> + <a name="M000107"></a> <div class="method-heading"> <span class="method-name">n_</span><span class="method-args">(arg1, arg2, arg3 = nil)</span> </div> <div class="method-description"> <p> -Alias for <a href="GetText.html#M000036">ngettext</a> +Alias for <a href="GetText.html#M000090">ngettext</a> </p> </div> </div> - <div id="method-M000036" class="method-detail"> - <a name="M000036"></a> + <div id="method-M000090" class="method-detail"> + <a name="M000090"></a> <div class="method-heading"> - <a href="#M000036" class="method-signature"> + <a href="#M000090" class="method-signature"> <span class="method-name">ngettext(msgid, msgid_plural, n)<br /> ngettext(msgids, n) # msgids = [msgid, msgid_plural]<br /> n_(msgid, msgid_plural, n)<br /> n_(msgids, n) # msgids = [msgid, msgid_plural]<br /> </span> </a> </div> <div class="method-description"> <p> -The <a href="GetText.html#M000036">ngettext</a> is similar to the <a -href="GetText.html#M000034">gettext</a> function as it finds the message +The <a href="GetText.html#M000090">ngettext</a> is similar to the <a +href="GetText.html#M000087">gettext</a> function as it finds the message catalogs in the same way. But it takes two extra arguments for plural form. </p> <ul> <li>msgid: the singular form. @@ -1045,53 +1052,109 @@ plural-rule) or msgid. &quot;plural-rule&quot; is defined in po-file. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000036-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000036-source"> + onclick="toggleCode('M000090-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000090-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 322</span> -322: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ngettext</span>(<span class="ruby-identifier">arg1</span>, <span class="ruby-identifier">arg2</span>, <span class="ruby-identifier">arg3</span> = <span class="ruby-keyword kw">nil</span>) -323: <span class="ruby-identifier">nsgettext</span>(<span class="ruby-identifier">arg1</span>, <span class="ruby-identifier">arg2</span>, <span class="ruby-identifier">arg3</span>, <span class="ruby-keyword kw">nil</span>) -324: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 340</span> +340: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ngettext</span>(<span class="ruby-identifier">arg1</span>, <span class="ruby-identifier">arg2</span>, <span class="ruby-identifier">arg3</span> = <span class="ruby-keyword kw">nil</span>) +341: <span class="ruby-identifier">nsgettext</span>(<span class="ruby-identifier">arg1</span>, <span class="ruby-identifier">arg2</span>, <span class="ruby-identifier">arg3</span>, <span class="ruby-keyword kw">nil</span>) +342: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000054" class="method-detail"> - <a name="M000054"></a> + <div id="method-M000091" class="method-detail"> + <a name="M000091"></a> <div class="method-heading"> + <a href="#M000091" class="method-signature"> + <span class="method-name">npgettext(msgctxt, msgid, msgid_plural, n)<br /> +npgettext(msgctxt, msgids, n) # msgids = [msgid, msgid_plural]<br /> +np_(msgctxt, msgid, msgid_plural, n)<br /> +np_(msgctxt, msgids, n) # msgids = [msgid, msgid_plural]<br /> +</span> + </a> + </div> + + <div class="method-description"> + <p> +The <a href="GetText.html#M000091">npgettext</a> is similar to the <a +href="GetText.html#M000094">nsgettext</a> function. +</p> +<pre> + e.g.) np_(&quot;Special&quot;, &quot;An apple&quot;, &quot;%{num} Apples&quot;, num) == ns_(&quot;Special|An apple&quot;, &quot;%{num} Apples&quot;, num) +</pre> +<ul> +<li>msgctxt: the message context. + +</li> +<li>msgid: the singular form. + +</li> +<li>msgid_plural: the plural form. + +</li> +<li>n: a number used to determine the plural form. + +</li> +<li>Returns: the localized text which key is msgid_plural if n is plural(follow +plural-rule) or msgid. &quot;plural-rule&quot; is defined in po-file. + +</li> +</ul> + <p><a class="source-toggle" href="#" + onclick="toggleCode('M000091-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000091-source"> +<pre> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 358</span> +358: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">npgettext</span>(<span class="ruby-identifier">msgctxt</span>, <span class="ruby-identifier">arg1</span>, <span class="ruby-identifier">arg2</span> = <span class="ruby-keyword kw">nil</span>) +359: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">arg1</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Array</span>) +360: <span class="ruby-identifier">nsgettext</span>(<span class="ruby-identifier">msgctxt</span> <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;\004&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">arg1</span>[<span class="ruby-value">0</span>], <span class="ruby-identifier">arg1</span>[<span class="ruby-value">1</span>], <span class="ruby-identifier">arg2</span>, <span class="ruby-keyword kw">nil</span>) +361: <span class="ruby-keyword kw">else</span> +362: <span class="ruby-identifier">nsgettext</span>(<span class="ruby-identifier">msgctxt</span> <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;\004&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">arg1</span>, <span class="ruby-identifier">arg2</span>, <span class="ruby-identifier">arg3</span>, <span class="ruby-keyword kw">nil</span>) +363: <span class="ruby-keyword kw">end</span> +364: <span class="ruby-keyword kw">end</span> +</pre> + </div> + </div> + </div> + + <div id="method-M000110" class="method-detail"> + <a name="M000110"></a> + + <div class="method-heading"> <span class="method-name">ns_</span><span class="method-args">(arg1, arg2, arg3 = &quot;|&quot;, arg4 = &quot;|&quot;)</span> </div> <div class="method-description"> <p> -Alias for <a href="GetText.html#M000039">nsgettext</a> +Alias for <a href="GetText.html#M000094">nsgettext</a> </p> </div> </div> - <div id="method-M000039" class="method-detail"> - <a name="M000039"></a> + <div id="method-M000094" class="method-detail"> + <a name="M000094"></a> <div class="method-heading"> - <a href="#M000039" class="method-signature"> + <a href="#M000094" class="method-signature"> <span class="method-name">nsgettext(msgid, msgid_plural, n, div = "|")<br /> nsgettext(msgids, n, div = "|") # msgids = [msgid, msgid_plural]<br /> n_(msgid, msgid_plural, n, div = "|")<br /> n_(msgids, n, div = "|") # msgids = [msgid, msgid_plural]<br /> </span> </a> </div> <div class="method-description"> <p> -The <a href="GetText.html#M000039">nsgettext</a> is similar to the <a -href="GetText.html#M000036">ngettext</a>. But if there are no localized +The <a href="GetText.html#M000094">nsgettext</a> is similar to the <a +href="GetText.html#M000090">ngettext</a>. But if there are no localized text, it returns a last part of msgid separeted &quot;div&quot;. </p> <ul> <li>msgid: the singular form with &quot;div&quot;. (e.g. &quot;Special|An apple&quot;) @@ -1107,167 +1170,230 @@ plural-rule) or msgid. &quot;plural-rule&quot; is defined in po-file. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000039-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000039-source"> + onclick="toggleCode('M000094-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000094-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 357</span> -357: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">nsgettext</span>(<span class="ruby-identifier">arg1</span>, <span class="ruby-identifier">arg2</span>, <span class="ruby-identifier">arg3</span> = <span class="ruby-value str">&quot;|&quot;</span>, <span class="ruby-identifier">arg4</span> = <span class="ruby-value str">&quot;|&quot;</span>) -358: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">arg1</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Array</span>) -359: <span class="ruby-identifier">msgid</span> = <span class="ruby-identifier">arg1</span>[<span class="ruby-value">0</span>] -360: <span class="ruby-identifier">msgid_plural</span> = <span class="ruby-identifier">arg1</span>[<span class="ruby-value">1</span>] -361: <span class="ruby-identifier">n</span> = <span class="ruby-identifier">arg2</span> -362: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">arg3</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">arg3</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Numeric</span> -363: <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-identifier">_</span>(<span class="ruby-value str">&quot;3rd parmeter is wrong: value = %{number}&quot;</span>) <span class="ruby-operator">%</span> {<span class="ruby-identifier">:number</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">arg3</span>} -364: <span class="ruby-keyword kw">end</span> -365: <span class="ruby-identifier">div</span> = <span class="ruby-identifier">arg3</span> -366: <span class="ruby-keyword kw">else</span> -367: <span class="ruby-identifier">msgid</span> = <span class="ruby-identifier">arg1</span> -368: <span class="ruby-identifier">msgid_plural</span> = <span class="ruby-identifier">arg2</span> -369: <span class="ruby-identifier">n</span> = <span class="ruby-identifier">arg3</span> -370: <span class="ruby-identifier">div</span> = <span class="ruby-identifier">arg4</span> -371: <span class="ruby-keyword kw">end</span> -372: -373: <span class="ruby-identifier">cached_key</span> = [<span class="ruby-identifier">bound_target</span>, <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">current</span>, <span class="ruby-identifier">msgid</span> <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;\000&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">msgid_plural</span>] -374: <span class="ruby-identifier">msgs</span> = <span class="ruby-keyword kw">nil</span> -375: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@@__cached</span> -376: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@@__cache_nmsgids</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">cached_key</span>) -377: <span class="ruby-identifier">msgs</span> = <span class="ruby-ivar">@@__cache_nmsgids</span>[<span class="ruby-identifier">cached_key</span>] <span class="ruby-comment cmt"># [msgstr, cond_as_string]</span> -378: <span class="ruby-keyword kw">end</span> -379: <span class="ruby-keyword kw">end</span> -380: <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">msgs</span> -381: <span class="ruby-comment cmt"># Use &quot;for&quot;(not &quot;each&quot;) to support JRuby 1.1.0.</span> -382: <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">target</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">bound_targets</span>(<span class="ruby-keyword kw">self</span>) -383: <span class="ruby-identifier">manager</span> = <span class="ruby-ivar">@@__textdomainmanagers</span>[<span class="ruby-identifier">target</span>] -384: <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">textdomain</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">manager</span>.<span class="ruby-identifier">textdomains</span> -385: <span class="ruby-identifier">msgs</span> = <span class="ruby-identifier">textdomain</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">ngettext_data</span>(<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">msgid_plural</span>) -386: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">msgs</span> -387: <span class="ruby-keyword kw">end</span> -388: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">msgs</span> -389: <span class="ruby-keyword kw">end</span> -390: <span class="ruby-identifier">msgs</span> = [[<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">msgid_plural</span>], <span class="ruby-value str">&quot;n != 1&quot;</span>] <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">msgs</span> -391: <span class="ruby-ivar">@@__cache_nmsgids</span>[<span class="ruby-identifier">cached_key</span>] = <span class="ruby-identifier">msgs</span> -392: <span class="ruby-keyword kw">end</span> -393: <span class="ruby-identifier">msgstrs</span> = <span class="ruby-identifier">msgs</span>[<span class="ruby-value">0</span>] -394: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">div</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">msgid</span> -395: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">index</span> = <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">rindex</span>(<span class="ruby-identifier">div</span>) -396: <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>] = <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>][(<span class="ruby-identifier">index</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>)<span class="ruby-operator">..</span><span class="ruby-value">-1</span>] -397: <span class="ruby-keyword kw">end</span> -398: <span class="ruby-keyword kw">end</span> -399: <span class="ruby-identifier">plural</span> = <span class="ruby-identifier">eval</span>(<span class="ruby-identifier">msgs</span>[<span class="ruby-value">1</span>]) -400: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">plural</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Numeric</span>) -401: <span class="ruby-identifier">ret</span> = <span class="ruby-identifier">msgstrs</span>[<span class="ruby-identifier">plural</span>] -402: <span class="ruby-keyword kw">else</span> -403: <span class="ruby-identifier">ret</span> = <span class="ruby-identifier">plural</span> <span class="ruby-value">? </span><span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">1</span>] <span class="ruby-operator">:</span> <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>] -404: <span class="ruby-keyword kw">end</span> -405: <span class="ruby-identifier">ret</span> -406: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 397</span> +397: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">nsgettext</span>(<span class="ruby-identifier">arg1</span>, <span class="ruby-identifier">arg2</span>, <span class="ruby-identifier">arg3</span> = <span class="ruby-value str">&quot;|&quot;</span>, <span class="ruby-identifier">arg4</span> = <span class="ruby-value str">&quot;|&quot;</span>) +398: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">arg1</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Array</span>) +399: <span class="ruby-identifier">msgid</span> = <span class="ruby-identifier">arg1</span>[<span class="ruby-value">0</span>] +400: <span class="ruby-identifier">msgid_plural</span> = <span class="ruby-identifier">arg1</span>[<span class="ruby-value">1</span>] +401: <span class="ruby-identifier">n</span> = <span class="ruby-identifier">arg2</span> +402: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">arg3</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">arg3</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Numeric</span> +403: <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-identifier">_</span>(<span class="ruby-value str">&quot;3rd parmeter is wrong: value = %{number}&quot;</span>) <span class="ruby-operator">%</span> {<span class="ruby-identifier">:number</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">arg3</span>} +404: <span class="ruby-keyword kw">end</span> +405: <span class="ruby-identifier">div</span> = <span class="ruby-identifier">arg3</span> +406: <span class="ruby-keyword kw">else</span> +407: <span class="ruby-identifier">msgid</span> = <span class="ruby-identifier">arg1</span> +408: <span class="ruby-identifier">msgid_plural</span> = <span class="ruby-identifier">arg2</span> +409: <span class="ruby-identifier">n</span> = <span class="ruby-identifier">arg3</span> +410: <span class="ruby-identifier">div</span> = <span class="ruby-identifier">arg4</span> +411: <span class="ruby-keyword kw">end</span> +412: +413: <span class="ruby-identifier">cached_key</span> = [<span class="ruby-identifier">bound_target</span>, <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">current</span>, <span class="ruby-identifier">msgid</span> <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;\000&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">msgid_plural</span>] +414: <span class="ruby-identifier">msgs</span> = <span class="ruby-keyword kw">nil</span> +415: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@@__cached</span> +416: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@@__cache_nmsgids</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">cached_key</span>) +417: <span class="ruby-identifier">msgs</span> = <span class="ruby-ivar">@@__cache_nmsgids</span>[<span class="ruby-identifier">cached_key</span>] <span class="ruby-comment cmt"># [msgstr, cond_as_string]</span> +418: <span class="ruby-keyword kw">end</span> +419: <span class="ruby-keyword kw">end</span> +420: <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">msgs</span> +421: <span class="ruby-comment cmt"># Use &quot;for&quot;(not &quot;each&quot;) to support JRuby 1.1.0.</span> +422: <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">target</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">bound_targets</span>(<span class="ruby-keyword kw">self</span>) +423: <span class="ruby-identifier">manager</span> = <span class="ruby-ivar">@@__textdomainmanagers</span>[<span class="ruby-identifier">target</span>] +424: <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">textdomain</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">manager</span>.<span class="ruby-identifier">textdomains</span> +425: <span class="ruby-identifier">msgs</span> = <span class="ruby-identifier">textdomain</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">ngettext_data</span>(<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">msgid_plural</span>) +426: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">msgs</span> +427: <span class="ruby-keyword kw">end</span> +428: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">msgs</span> +429: <span class="ruby-keyword kw">end</span> +430: <span class="ruby-identifier">msgs</span> = [[<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">msgid_plural</span>], <span class="ruby-value str">&quot;n != 1&quot;</span>] <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">msgs</span> +431: <span class="ruby-ivar">@@__cache_nmsgids</span>[<span class="ruby-identifier">cached_key</span>] = <span class="ruby-identifier">msgs</span> +432: <span class="ruby-keyword kw">end</span> +433: <span class="ruby-identifier">msgstrs</span> = <span class="ruby-identifier">msgs</span>[<span class="ruby-value">0</span>] +434: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">div</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">msgid</span> +435: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">index</span> = <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>].<span class="ruby-identifier">rindex</span>(<span class="ruby-identifier">div</span>) +436: <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>] = <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>][(<span class="ruby-identifier">index</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>)<span class="ruby-operator">..</span><span class="ruby-value">-1</span>] +437: <span class="ruby-keyword kw">end</span> +438: <span class="ruby-keyword kw">end</span> +439: <span class="ruby-identifier">plural</span> = <span class="ruby-identifier">eval</span>(<span class="ruby-identifier">msgs</span>[<span class="ruby-value">1</span>]) +440: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">plural</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Numeric</span>) +441: <span class="ruby-identifier">ret</span> = <span class="ruby-identifier">msgstrs</span>[<span class="ruby-identifier">plural</span>] +442: <span class="ruby-keyword kw">else</span> +443: <span class="ruby-identifier">ret</span> = <span class="ruby-identifier">plural</span> <span class="ruby-value">? </span><span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">1</span>] <span class="ruby-operator">:</span> <span class="ruby-identifier">msgstrs</span>[<span class="ruby-value">0</span>] +444: <span class="ruby-keyword kw">end</span> +445: <span class="ruby-identifier">ret</span> +446: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000045" class="method-detail"> - <a name="M000045"></a> + <div id="method-M000100" class="method-detail"> + <a name="M000100"></a> <div class="method-heading"> - <a href="#M000045" class="method-signature"> + <a href="#M000100" class="method-signature"> <span class="method-name">output_charset</span><span class="method-args">()</span> </a> </div> <div class="method-description"> <p> -Gets the current <a href="GetText.html#M000045">output_charset</a> which is -set using <a href="GetText.html#M000043">GetText.set_output_charset</a>. +Gets the current <a href="GetText.html#M000100">output_charset</a> which is +set using <a href="GetText.html#M000098">GetText.set_output_charset</a>. </p> <ul> -<li>Returns: <a href="GetText.html#M000045">output_charset</a>. +<li>Returns: <a href="GetText.html#M000100">output_charset</a>. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000045-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000045-source"> + onclick="toggleCode('M000100-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000100-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 497</span> -497: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">output_charset</span> -498: <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">locale</span>.<span class="ruby-identifier">charset</span> -499: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 537</span> +537: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">output_charset</span> +538: <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">locale</span>.<span class="ruby-identifier">charset</span> +539: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000044" class="method-detail"> - <a name="M000044"></a> + <div id="method-M000099" class="method-detail"> + <a name="M000099"></a> <div class="method-heading"> - <a href="#M000044" class="method-signature"> + <a href="#M000099" class="method-signature"> <span class="method-name">output_charset=</span><span class="method-args">(charset)</span> </a> </div> <div class="method-description"> <p> -Same as <a href="GetText.html#M000043">GetText.set_output_charset</a> +Same as <a href="GetText.html#M000098">GetText.set_output_charset</a> </p> <ul> -<li>charset: an <a href="GetText.html#M000045">output_charset</a> +<li>charset: an <a href="GetText.html#M000100">output_charset</a> </li> <li>Returns: charset </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000044-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000044-source"> + onclick="toggleCode('M000099-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000099-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 491</span> -491: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">output_charset=</span>(<span class="ruby-identifier">charset</span>) -492: <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> = <span class="ruby-identifier">charset</span> -493: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 531</span> +531: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">output_charset=</span>(<span class="ruby-identifier">charset</span>) +532: <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> = <span class="ruby-identifier">charset</span> +533: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000049" class="method-detail"> - <a name="M000049"></a> + <div id="method-M000109" class="method-detail"> + <a name="M000109"></a> <div class="method-heading"> - <a href="#M000049" class="method-signature"> + <span class="method-name">p_</span><span class="method-args">(msgctxt, msgid)</span> + </div> + + <div class="method-description"> + <p> +Alias for <a href="GetText.html#M000089">pgettext</a> +</p> + </div> + </div> + + <div id="method-M000089" class="method-detail"> + <a name="M000089"></a> + + <div class="method-heading"> + <a href="#M000089" class="method-signature"> + <span class="method-name">pgettext(msgctxt, msgid)<br /> +p_(msgctxt, msgid)<br /> +</span> + </a> + </div> + + <div class="method-description"> + <p> +Translates msgid with msgctxt. This methods is similer with <a +href="GetText.html#M000108">s_</a>(). +</p> +<pre> + e.g.) p_(&quot;File&quot;, &quot;New&quot;) == s_(&quot;File|New&quot;) + p_(&quot;File&quot;, &quot;Open&quot;) == s_(&quot;File|Open&quot;) +</pre> +<ul> +<li>msgctxt: the message context. + +</li> +<li>msgid: the message id. + +</li> +<li>Returns: the localized text by msgid. If there are no localized text, it +returns msgid. + +</li> +</ul> +<p> +See: <a +href="http://www.gnu.org/software/autoconf/manual/gettext/Contexts.html">www.gnu.org/software/autoconf/manual/gettext/Contexts.html</a> +</p> + <p><a class="source-toggle" href="#" + onclick="toggleCode('M000089-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000089-source"> +<pre> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 320</span> +320: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pgettext</span>(<span class="ruby-identifier">msgctxt</span>, <span class="ruby-identifier">msgid</span>) +321: <span class="ruby-identifier">sgettext</span>(<span class="ruby-identifier">msgctxt</span> <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;\004&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">msgid</span>, <span class="ruby-value str">&quot;\004&quot;</span>) +322: <span class="ruby-keyword kw">end</span> +</pre> + </div> + </div> + </div> + + <div id="method-M000104" class="method-detail"> + <a name="M000104"></a> + + <div class="method-heading"> + <a href="#M000104" class="method-signature"> <span class="method-name">remove_all_textdomains</span><span class="method-args">()</span> </a> </div> <div class="method-description"> <p> for testing. </p> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000049-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000049-source"> + onclick="toggleCode('M000104-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000104-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 543</span> -543: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove_all_textdomains</span> -544: <span class="ruby-identifier">clear_cache</span> -545: <span class="ruby-ivar">@@__textdomainmanagers</span> = {} -546: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 583</span> +583: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove_all_textdomains</span> +584: <span class="ruby-identifier">clear_cache</span> +585: <span class="ruby-ivar">@@__textdomainmanagers</span> = {} +586: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000021" class="method-detail"> - <a name="M000021"></a> + <div id="method-M000074" class="method-detail"> + <a name="M000074"></a> <div class="method-heading"> - <a href="#M000021" class="method-signature"> + <a href="#M000074" class="method-signature"> <span class="method-name">rgettext</span><span class="method-args">(targetfiles = nil, out = STDOUT)</span> </a> </div> <div class="method-description"> @@ -1294,37 +1420,37 @@ <li>Returns: self </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000021-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000021-source"> + onclick="toggleCode('M000074-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000074-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext/rgettext.rb, line 259</span> -259: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rgettext</span>(<span class="ruby-identifier">targetfiles</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">out</span> = <span class="ruby-constant">STDOUT</span>) -260: <span class="ruby-constant">RGetText</span>.<span class="ruby-identifier">run</span>(<span class="ruby-identifier">targetfiles</span>, <span class="ruby-identifier">out</span>) -261: <span class="ruby-keyword kw">self</span> -262: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext/rgettext.rb, line 264</span> +264: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rgettext</span>(<span class="ruby-identifier">targetfiles</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">out</span> = <span class="ruby-constant">STDOUT</span>) +265: <span class="ruby-constant">RGetText</span>.<span class="ruby-identifier">run</span>(<span class="ruby-identifier">targetfiles</span>, <span class="ruby-identifier">out</span>) +266: <span class="ruby-keyword kw">self</span> +267: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000022" class="method-detail"> - <a name="M000022"></a> + <div id="method-M000075" class="method-detail"> + <a name="M000075"></a> <div class="method-heading"> - <a href="#M000022" class="method-signature"> + <a href="#M000075" class="method-signature"> <span class="method-name">rmsgfmt</span><span class="method-args">(targetfile = nil, output_path = nil)</span> </a> </div> <div class="method-description"> <p> Creates a mo-file from a targetfile(po-file), then output the result to out. If no parameter is set, it behaves same as command line tools(<a -href="GetText.html#M000022">rmsgfmt</a>). +href="GetText.html#M000075">rmsgfmt</a>). </p> <ul> <li>targetfile: An Array of po-files or nil. </li> @@ -1334,67 +1460,67 @@ <li>Returns: the <a href="MOFile.html">MOFile</a> object. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000022-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000022-source"> + onclick="toggleCode('M000075-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000075-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext/rmsgfmt.rb, line 79</span> 79: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rmsgfmt</span>(<span class="ruby-identifier">targetfile</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">output_path</span> = <span class="ruby-keyword kw">nil</span>) 80: <span class="ruby-constant">RMsgfmt</span>.<span class="ruby-identifier">run</span>(<span class="ruby-identifier">targetfile</span>, <span class="ruby-identifier">output_path</span>) 81: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000026" class="method-detail"> - <a name="M000026"></a> + <div id="method-M000079" class="method-detail"> + <a name="M000079"></a> <div class="method-heading"> - <a href="#M000026" class="method-signature"> + <a href="#M000079" class="method-signature"> <span class="method-name">rmsgmerge</span><span class="method-args">(reference = nil, definition = nil, out = STDOUT)</span> </a> </div> <div class="method-description"> <p> Experimental </p> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000026-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000026-source"> + onclick="toggleCode('M000079-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000079-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext/rmsgmerge.rb, line 489</span> 489: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rmsgmerge</span>(<span class="ruby-identifier">reference</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">definition</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">out</span> = <span class="ruby-constant">STDOUT</span>) 490: <span class="ruby-constant">RMsgMerge</span>.<span class="ruby-identifier">run</span>(<span class="ruby-identifier">reference</span>, <span class="ruby-identifier">definition</span>, <span class="ruby-identifier">out</span>) 491: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000053" class="method-detail"> - <a name="M000053"></a> + <div id="method-M000108" class="method-detail"> + <a name="M000108"></a> <div class="method-heading"> <span class="method-name">s_</span><span class="method-args">(msgid, div = '|')</span> </div> <div class="method-description"> <p> -Alias for <a href="GetText.html#M000035">sgettext</a> +Alias for <a href="GetText.html#M000088">sgettext</a> </p> </div> </div> - <div id="method-M000023" class="method-detail"> - <a name="M000023"></a> + <div id="method-M000076" class="method-detail"> + <a name="M000076"></a> <div class="method-heading"> - <a href="#M000023" class="method-signature"> + <a href="#M000076" class="method-signature"> <span class="method-name">set_cgi</span><span class="method-args">(cgi_)</span> </a> </div> <div class="method-description"> @@ -1408,155 +1534,155 @@ <li>Returns: self </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000023-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000023-source"> + onclick="toggleCode('M000076-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000076-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext/cgi.rb, line 22</span> 22: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_cgi</span>(<span class="ruby-identifier">cgi_</span>) 23: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">set_cgi</span>(<span class="ruby-identifier">cgi_</span>) 24: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000040" class="method-detail"> - <a name="M000040"></a> + <div id="method-M000095" class="method-detail"> + <a name="M000095"></a> <div class="method-heading"> - <a href="#M000040" class="method-signature"> + <a href="#M000095" class="method-signature"> <span class="method-name">set_locale</span><span class="method-args">(locale, this_target_only = false)</span> </a> </div> <div class="method-description"> <p> -Sets the current <a href="GetText.html#M000046">locale</a> to the current +Sets the current <a href="GetText.html#M000101">locale</a> to the current class/module </p> <p> Notice that you shouldn&#8216;t use this for your own Libraries. </p> <ul> -<li><a href="GetText.html#M000046">locale</a>: a <a -href="GetText.html#M000046">locale</a> string or <a +<li><a href="GetText.html#M000101">locale</a>: a <a +href="GetText.html#M000101">locale</a> string or <a href="Locale/Object.html">Locale::Object</a>. </li> <li>this_target_only: true if you want to change the current class/module only. </li> </ul> <p> -Otherwise, this changes the <a href="GetText.html#M000046">locale</a> of +Otherwise, this changes the <a href="GetText.html#M000101">locale</a> of the current class/module and its ancestors. Default is false. </p> <ul> <li>Returns: self </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000040-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000040-source"> + onclick="toggleCode('M000095-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000095-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 416</span> -416: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_locale</span>(<span class="ruby-identifier">locale</span>, <span class="ruby-identifier">this_target_only</span> = <span class="ruby-keyword kw">false</span>) -417: <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">nil</span> -418: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">locale</span> -419: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">locale</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Locale</span><span class="ruby-operator">::</span><span class="ruby-constant">Object</span> -420: <span class="ruby-identifier">ret</span> = <span class="ruby-identifier">locale</span> -421: <span class="ruby-keyword kw">else</span> -422: <span class="ruby-identifier">ret</span> = <span class="ruby-constant">Locale</span><span class="ruby-operator">::</span><span class="ruby-constant">Object</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">locale</span>.<span class="ruby-identifier">to_s</span>) -423: <span class="ruby-keyword kw">end</span> -424: <span class="ruby-identifier">ret</span>.<span class="ruby-identifier">charset</span> = <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> <span class="ruby-keyword kw">if</span> <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> -425: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">set</span>(<span class="ruby-identifier">ret</span>) -426: <span class="ruby-keyword kw">else</span> -427: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">set</span>(<span class="ruby-keyword kw">nil</span>) -428: <span class="ruby-identifier">ret</span> = <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">get</span> -429: <span class="ruby-keyword kw">end</span> -430: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">this_target_only</span> -431: <span class="ruby-identifier">manager</span> = <span class="ruby-ivar">@@__textdomainmanagers</span>[<span class="ruby-identifier">bound_target</span>] -432: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">manager</span> -433: <span class="ruby-identifier">manager</span>.<span class="ruby-identifier">set_locale</span>(<span class="ruby-identifier">ret</span>, <span class="ruby-operator">!</span> <span class="ruby-identifier">cached?</span>) -434: <span class="ruby-keyword kw">end</span> -435: <span class="ruby-keyword kw">else</span> -436: <span class="ruby-identifier">each_textdomain</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">textdomain</span><span class="ruby-operator">|</span> -437: <span class="ruby-identifier">textdomain</span>.<span class="ruby-identifier">set_locale</span>(<span class="ruby-identifier">ret</span>, <span class="ruby-operator">!</span> <span class="ruby-identifier">cached?</span>) -438: } -439: <span class="ruby-keyword kw">end</span> -440: <span class="ruby-keyword kw">self</span> -441: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 456</span> +456: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_locale</span>(<span class="ruby-identifier">locale</span>, <span class="ruby-identifier">this_target_only</span> = <span class="ruby-keyword kw">false</span>) +457: <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">nil</span> +458: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">locale</span> +459: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">locale</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Locale</span><span class="ruby-operator">::</span><span class="ruby-constant">Object</span> +460: <span class="ruby-identifier">ret</span> = <span class="ruby-identifier">locale</span> +461: <span class="ruby-keyword kw">else</span> +462: <span class="ruby-identifier">ret</span> = <span class="ruby-constant">Locale</span><span class="ruby-operator">::</span><span class="ruby-constant">Object</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">locale</span>.<span class="ruby-identifier">to_s</span>) +463: <span class="ruby-keyword kw">end</span> +464: <span class="ruby-identifier">ret</span>.<span class="ruby-identifier">charset</span> = <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> <span class="ruby-keyword kw">if</span> <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> +465: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">set</span>(<span class="ruby-identifier">ret</span>) +466: <span class="ruby-keyword kw">else</span> +467: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">set</span>(<span class="ruby-keyword kw">nil</span>) +468: <span class="ruby-identifier">ret</span> = <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">get</span> +469: <span class="ruby-keyword kw">end</span> +470: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">this_target_only</span> +471: <span class="ruby-identifier">manager</span> = <span class="ruby-ivar">@@__textdomainmanagers</span>[<span class="ruby-identifier">bound_target</span>] +472: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">manager</span> +473: <span class="ruby-identifier">manager</span>.<span class="ruby-identifier">set_locale</span>(<span class="ruby-identifier">ret</span>, <span class="ruby-operator">!</span> <span class="ruby-identifier">cached?</span>) +474: <span class="ruby-keyword kw">end</span> +475: <span class="ruby-keyword kw">else</span> +476: <span class="ruby-identifier">each_textdomain</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">textdomain</span><span class="ruby-operator">|</span> +477: <span class="ruby-identifier">textdomain</span>.<span class="ruby-identifier">set_locale</span>(<span class="ruby-identifier">ret</span>, <span class="ruby-operator">!</span> <span class="ruby-identifier">cached?</span>) +478: } +479: <span class="ruby-keyword kw">end</span> +480: <span class="ruby-keyword kw">self</span> +481: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000041" class="method-detail"> - <a name="M000041"></a> + <div id="method-M000096" class="method-detail"> + <a name="M000096"></a> <div class="method-heading"> - <a href="#M000041" class="method-signature"> + <a href="#M000096" class="method-signature"> <span class="method-name">set_locale_all</span><span class="method-args">(locale)</span> </a> </div> <div class="method-description"> <p> -Sets current <a href="GetText.html#M000046">locale</a> to the all +Sets current <a href="GetText.html#M000101">locale</a> to the all textdomains. </p> <p> Note that you shouldn&#8216;t use this for your own Libraries. </p> <ul> -<li><a href="GetText.html#M000046">locale</a>: a <a -href="GetText.html#M000046">locale</a> string or <a +<li><a href="GetText.html#M000101">locale</a>: a <a +href="GetText.html#M000101">locale</a> string or <a href="Locale/Object.html">Locale::Object</a>, otherwise nil to use default -<a href="GetText.html#M000046">locale</a>. +<a href="GetText.html#M000101">locale</a>. </li> <li>Returns: self </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000041-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000041-source"> + onclick="toggleCode('M000096-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000096-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 448</span> -448: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_locale_all</span>(<span class="ruby-identifier">locale</span>) -449: <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">nil</span> -450: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">locale</span> -451: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">locale</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Locale</span><span class="ruby-operator">::</span><span class="ruby-constant">Object</span> -452: <span class="ruby-identifier">ret</span> = <span class="ruby-identifier">locale</span> -453: <span class="ruby-keyword kw">else</span> -454: <span class="ruby-identifier">ret</span> = <span class="ruby-constant">Locale</span><span class="ruby-operator">::</span><span class="ruby-constant">Object</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">locale</span>.<span class="ruby-identifier">to_s</span>) -455: <span class="ruby-keyword kw">end</span> -456: <span class="ruby-keyword kw">else</span> -457: <span class="ruby-identifier">ret</span> = <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">default</span> -458: <span class="ruby-keyword kw">end</span> -459: <span class="ruby-identifier">ret</span>.<span class="ruby-identifier">charset</span> = <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> <span class="ruby-keyword kw">if</span> <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> -460: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">set_current</span>(<span class="ruby-identifier">ret</span>) -461: <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">each_all</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">textdomain</span><span class="ruby-operator">|</span> -462: <span class="ruby-identifier">textdomain</span>.<span class="ruby-identifier">set_locale</span>(<span class="ruby-identifier">ret</span>, <span class="ruby-operator">!</span> <span class="ruby-identifier">cached?</span>) -463: } -464: <span class="ruby-keyword kw">self</span> -465: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 488</span> +488: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_locale_all</span>(<span class="ruby-identifier">locale</span>) +489: <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">nil</span> +490: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">locale</span> +491: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">locale</span>.<span class="ruby-identifier">kind_of?</span> <span class="ruby-constant">Locale</span><span class="ruby-operator">::</span><span class="ruby-constant">Object</span> +492: <span class="ruby-identifier">ret</span> = <span class="ruby-identifier">locale</span> +493: <span class="ruby-keyword kw">else</span> +494: <span class="ruby-identifier">ret</span> = <span class="ruby-constant">Locale</span><span class="ruby-operator">::</span><span class="ruby-constant">Object</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">locale</span>.<span class="ruby-identifier">to_s</span>) +495: <span class="ruby-keyword kw">end</span> +496: <span class="ruby-keyword kw">else</span> +497: <span class="ruby-identifier">ret</span> = <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">default</span> +498: <span class="ruby-keyword kw">end</span> +499: <span class="ruby-identifier">ret</span>.<span class="ruby-identifier">charset</span> = <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> <span class="ruby-keyword kw">if</span> <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> +500: <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">set_current</span>(<span class="ruby-identifier">ret</span>) +501: <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">each_all</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">textdomain</span><span class="ruby-operator">|</span> +502: <span class="ruby-identifier">textdomain</span>.<span class="ruby-identifier">set_locale</span>(<span class="ruby-identifier">ret</span>, <span class="ruby-operator">!</span> <span class="ruby-identifier">cached?</span>) +503: } +504: <span class="ruby-keyword kw">self</span> +505: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000043" class="method-detail"> - <a name="M000043"></a> + <div id="method-M000098" class="method-detail"> + <a name="M000098"></a> <div class="method-heading"> - <a href="#M000043" class="method-signature"> + <a href="#M000098" class="method-signature"> <span class="method-name">set_output_charset</span><span class="method-args">(charset)</span> </a> </div> <div class="method-description"> @@ -1564,50 +1690,50 @@ Sets charset(<a href="String.html">String</a>) such as &quot;euc-jp&quot;, &quot;sjis&quot;, &quot;CP932&quot;, &quot;utf-8&quot;, &#8230; You shouldn&#8216;t use this in your own Libraries. </p> <ul> -<li>charset: an <a href="GetText.html#M000045">output_charset</a> +<li>charset: an <a href="GetText.html#M000100">output_charset</a> </li> <li>Returns: charset </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000043-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000043-source"> + onclick="toggleCode('M000098-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000098-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 483</span> -483: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_output_charset</span>(<span class="ruby-identifier">charset</span>) -484: <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> = <span class="ruby-identifier">charset</span> -485: <span class="ruby-keyword kw">self</span> -486: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 523</span> +523: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_output_charset</span>(<span class="ruby-identifier">charset</span>) +524: <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">output_charset</span> = <span class="ruby-identifier">charset</span> +525: <span class="ruby-keyword kw">self</span> +526: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000050" class="method-detail"> - <a name="M000050"></a> + <div id="method-M000105" class="method-detail"> + <a name="M000105"></a> <div class="method-heading"> <span class="method-name">setlocale</span><span class="method-args">(locale)</span> </div> <div class="method-description"> <p> -Alias for <a href="GetText.html#M000046">locale</a>= +Alias for <a href="GetText.html#M000101">locale</a>= </p> </div> </div> - <div id="method-M000035" class="method-detail"> - <a name="M000035"></a> + <div id="method-M000088" class="method-detail"> + <a name="M000088"></a> <div class="method-heading"> - <a href="#M000035" class="method-signature"> + <a href="#M000088" class="method-signature"> <span class="method-name">sgettext(msgid, div = '|')<br /> s_(msgid, div = '|')<br /> </span> </a> </div> @@ -1632,77 +1758,77 @@ <p> See: <a href="http://www.gnu.org/software/gettext/manual/html_mono/gettext.html#SEC151">www.gnu.org/software/gettext/manual/html_mono/gettext.html#SEC151</a> </p> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000035-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000035-source"> + onclick="toggleCode('M000088-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000088-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext.rb, line 278</span> -278: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sgettext</span>(<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">div</span> = <span class="ruby-value str">'|'</span>) -279: <span class="ruby-identifier">cached_key</span> = [<span class="ruby-identifier">bound_target</span>, <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">current</span>, <span class="ruby-identifier">msgid</span>] -280: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">cached?</span> -281: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@@__cache_msgids</span>[<span class="ruby-identifier">cached_key</span>] -282: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@@__cache_msgids</span>[<span class="ruby-identifier">cached_key</span>] -283: <span class="ruby-keyword kw">end</span> -284: <span class="ruby-keyword kw">end</span> -285: <span class="ruby-identifier">msg</span> = <span class="ruby-keyword kw">nil</span> -286: -287: <span class="ruby-comment cmt"># Use &quot;for&quot;(not &quot;each&quot;) to support JRuby 1.1.0.</span> -288: <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">target</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">bound_targets</span>(<span class="ruby-keyword kw">self</span>) -289: <span class="ruby-identifier">manager</span> = <span class="ruby-ivar">@@__textdomainmanagers</span>[<span class="ruby-identifier">target</span>] -290: <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">textdomain</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">manager</span>.<span class="ruby-identifier">textdomains</span> -291: <span class="ruby-identifier">msg</span> = <span class="ruby-identifier">textdomain</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">gettext</span>(<span class="ruby-identifier">msgid</span>) -292: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">msg</span> -293: <span class="ruby-keyword kw">end</span> -294: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">msg</span> -295: <span class="ruby-keyword kw">end</span> -296: -297: <span class="ruby-identifier">msg</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">msgid</span> -298: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">div</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">msg</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">msgid</span> -299: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">index</span> = <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">rindex</span>(<span class="ruby-identifier">div</span>) -300: <span class="ruby-identifier">msg</span> = <span class="ruby-identifier">msg</span>[(<span class="ruby-identifier">index</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>)<span class="ruby-operator">..</span><span class="ruby-value">-1</span>] -301: <span class="ruby-keyword kw">end</span> -302: <span class="ruby-keyword kw">end</span> -303: <span class="ruby-ivar">@@__cache_msgids</span>[<span class="ruby-identifier">cached_key</span>] = <span class="ruby-identifier">msg</span> -304: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext.rb, line 279</span> +279: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sgettext</span>(<span class="ruby-identifier">msgid</span>, <span class="ruby-identifier">div</span> = <span class="ruby-value str">'|'</span>) +280: <span class="ruby-identifier">cached_key</span> = [<span class="ruby-identifier">bound_target</span>, <span class="ruby-constant">Locale</span>.<span class="ruby-identifier">current</span>, <span class="ruby-identifier">msgid</span>] +281: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">cached?</span> +282: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@@__cache_msgids</span>[<span class="ruby-identifier">cached_key</span>] +283: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@@__cache_msgids</span>[<span class="ruby-identifier">cached_key</span>] +284: <span class="ruby-keyword kw">end</span> +285: <span class="ruby-keyword kw">end</span> +286: <span class="ruby-identifier">msg</span> = <span class="ruby-keyword kw">nil</span> +287: +288: <span class="ruby-comment cmt"># Use &quot;for&quot;(not &quot;each&quot;) to support JRuby 1.1.0.</span> +289: <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">target</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">bound_targets</span>(<span class="ruby-keyword kw">self</span>) +290: <span class="ruby-identifier">manager</span> = <span class="ruby-ivar">@@__textdomainmanagers</span>[<span class="ruby-identifier">target</span>] +291: <span class="ruby-keyword kw">for</span> <span class="ruby-identifier">textdomain</span> <span class="ruby-keyword kw">in</span> <span class="ruby-identifier">manager</span>.<span class="ruby-identifier">textdomains</span> +292: <span class="ruby-identifier">msg</span> = <span class="ruby-identifier">textdomain</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">gettext</span>(<span class="ruby-identifier">msgid</span>) +293: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">msg</span> +294: <span class="ruby-keyword kw">end</span> +295: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">msg</span> +296: <span class="ruby-keyword kw">end</span> +297: +298: <span class="ruby-identifier">msg</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">msgid</span> +299: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">div</span> <span class="ruby-keyword kw">and</span> <span class="ruby-identifier">msg</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">msgid</span> +300: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">index</span> = <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">rindex</span>(<span class="ruby-identifier">div</span>) +301: <span class="ruby-identifier">msg</span> = <span class="ruby-identifier">msg</span>[(<span class="ruby-identifier">index</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>)<span class="ruby-operator">..</span><span class="ruby-value">-1</span>] +302: <span class="ruby-keyword kw">end</span> +303: <span class="ruby-keyword kw">end</span> +304: <span class="ruby-ivar">@@__cache_msgids</span>[<span class="ruby-identifier">cached_key</span>] = <span class="ruby-identifier">msg</span> +305: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> - <div id="method-M000032" class="method-detail"> - <a name="M000032"></a> + <div id="method-M000085" class="method-detail"> + <a name="M000085"></a> <div class="method-heading"> - <a href="#M000032" class="method-signature"> + <a href="#M000085" class="method-signature"> <span class="method-name">textdomain</span><span class="method-args">(domainname)</span> </a> </div> <div class="method-description"> <p> -Binds a existed <a href="GetText.html#M000032">textdomain</a> to your +Binds a existed <a href="GetText.html#M000085">textdomain</a> to your program. This is the same function with <a -href="GetText.html#M000030">GetText.bindtextdomain</a> but simpler(and -faster) than <a href="GetText.html#M000030">bindtextdomain</a>. Notice that -you need to call <a href="GetText.html#M000030">GetText.bindtextdomain</a> +href="GetText.html#M000083">GetText.bindtextdomain</a> but simpler(and +faster) than <a href="GetText.html#M000083">bindtextdomain</a>. Notice that +you need to call <a href="GetText.html#M000083">GetText.bindtextdomain</a> first. If the domainname hasn&#8216;t bound yet, raises <a href="GetText/NoboundTextDomainError.html">GetText::NoboundTextDomainError</a>. </p> <ul> -<li>domainname: a <a href="GetText.html#M000032">textdomain</a> name. +<li>domainname: a <a href="GetText.html#M000085">textdomain</a> name. </li> <li>Returns: the <a href="GetText/TextDomainManager.html">GetText::TextDomainManager</a>. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000032-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000032-source"> + onclick="toggleCode('M000085-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000085-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext.rb, line 128</span> 128: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">textdomain</span>(<span class="ruby-identifier">domainname</span>) 129: <span class="ruby-identifier">domain</span> = <span class="ruby-constant">TextDomainManager</span>.<span class="ruby-identifier">textdomain</span>(<span class="ruby-identifier">domainname</span>) 130: <span class="ruby-identifier">raise</span> <span class="ruby-constant">NoboundTextDomainError</span>, <span class="ruby-node">&quot;#{domainname} is not bound.&quot;</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">domain</span> @@ -1719,36 +1845,36 @@ </pre> </div> </div> </div> - <div id="method-M000033" class="method-detail"> - <a name="M000033"></a> + <div id="method-M000086" class="method-detail"> + <a name="M000086"></a> <div class="method-heading"> - <a href="#M000033" class="method-signature"> + <a href="#M000086" class="method-signature"> <span class="method-name">textdomain_to</span><span class="method-args">(klass, domainname)</span> </a> </div> <div class="method-description"> <p> Includes <a href="GetText.html">GetText</a> module and bind an exsited <a -href="GetText.html#M000032">textdomain</a> to a class. See <a -href="GetText.html#M000032">textdomain</a> for more detail. +href="GetText.html#M000085">textdomain</a> to a class. See <a +href="GetText.html#M000085">textdomain</a> for more detail. </p> <ul> <li>klass: the target ruby class. </li> -<li>domainname: the <a href="GetText.html#M000032">textdomain</a> name. +<li>domainname: the <a href="GetText.html#M000085">textdomain</a> name. </li> </ul> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000033-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000033-source"> + onclick="toggleCode('M000086-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000086-source"> <pre> <span class="ruby-comment cmt"># File lib/gettext.rb, line 146</span> 146: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">textdomain_to</span>(<span class="ruby-identifier">klass</span>, <span class="ruby-identifier">domainname</span>) 147: <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">nil</span> 148: <span class="ruby-identifier">klass</span>.<span class="ruby-identifier">module_eval</span> { @@ -1760,43 +1886,43 @@ </pre> </div> </div> </div> - <div id="method-M000020" class="method-detail"> - <a name="M000020"></a> + <div id="method-M000073" class="method-detail"> + <a name="M000073"></a> <div class="method-heading"> - <a href="#M000020" class="method-signature"> + <a href="#M000073" class="method-signature"> <span class="method-name">update_pofiles</span><span class="method-args">(textdomain, files, app_version, po_root = &quot;po&quot;, refpot = &quot;tmp.pot&quot;)</span> </a> </div> <div class="method-description"> <p> At first, this creates the #{po_root}/#{domainname}.pot file using <a -href="GetText.html#M000021">GetText.rgettext</a>. Since 2nd time, this +href="GetText.html#M000074">GetText.rgettext</a>. Since 2nd time, this updates(merges) the #{po_root}/#{domainname}.pot and all of the #{po_root}/#{lang}/#{domainname}.po files under &quot;po_root&quot; using -&quot;<a href="GetText.html#M000018">msgmerge</a>&quot;. +&quot;<a href="GetText.html#M000071">msgmerge</a>&quot;. </p> <p> -<b>Note</b> &quot;<a href="GetText.html#M000018">msgmerge</a>&quot; tool is +<b>Note</b> &quot;<a href="GetText.html#M000071">msgmerge</a>&quot; tool is included in GNU <a href="GetText.html">GetText</a>. So you need to install GNU <a href="GetText.html">GetText</a>. </p> <p> See &lt;HOWTO maintain po/mo files(<a href="http://www.yotabanana.com/hiki/ruby-gettext-howto-manage.html">www.yotabanana.com/hiki/ruby-gettext-howto-manage.html</a>)&gt; for more detals. </p> <ul> -<li>domainname: the <a href="GetText.html#M000032">textdomain</a> name. +<li>domainname: the <a href="GetText.html#M000085">textdomain</a> name. </li> <li>targetfiles: An Array of target files or nil (See <a -href="GetText.html#M000021">GetText.rgettext</a> for more details). +href="GetText.html#M000074">GetText.rgettext</a> for more details). </li> <li>app_version: the application information which appears &quot;Project-Id-Version: #{app_version}&quot; in the pot/po-files. @@ -1811,18 +1937,18 @@ </ul> <pre> (e.g.) GetText.update_pofiles(&quot;myapp&quot;, Dir.glob(&quot;lib/*.rb&quot;), &quot;myapp 1.0.0&quot;) </pre> <p><a class="source-toggle" href="#" - onclick="toggleCode('M000020-source');return false;">[Source]</a></p> - <div class="method-source-code" id="M000020-source"> + onclick="toggleCode('M000073-source');return false;">[Source]</a></p> + <div class="method-source-code" id="M000073-source"> <pre> - <span class="ruby-comment cmt"># File lib/gettext/utils.rb, line 127</span> -127: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_pofiles</span>(<span class="ruby-identifier">textdomain</span>, <span class="ruby-identifier">files</span>, <span class="ruby-identifier">app_version</span>, <span class="ruby-identifier">po_root</span> = <span class="ruby-value str">&quot;po&quot;</span>, <span class="ruby-identifier">refpot</span> = <span class="ruby-value str">&quot;tmp.pot&quot;</span>) -128: <span class="ruby-identifier">rgettext</span>(<span class="ruby-identifier">files</span>, <span class="ruby-identifier">refpot</span>) -129: <span class="ruby-identifier">msgmerge_all</span>(<span class="ruby-identifier">textdomain</span>, <span class="ruby-identifier">app_version</span>, <span class="ruby-identifier">po_root</span>, <span class="ruby-identifier">refpot</span>) -130: <span class="ruby-constant">File</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">refpot</span>) -131: <span class="ruby-keyword kw">end</span> + <span class="ruby-comment cmt"># File lib/gettext/utils.rb, line 131</span> +131: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">update_pofiles</span>(<span class="ruby-identifier">textdomain</span>, <span class="ruby-identifier">files</span>, <span class="ruby-identifier">app_version</span>, <span class="ruby-identifier">po_root</span> = <span class="ruby-value str">&quot;po&quot;</span>, <span class="ruby-identifier">refpot</span> = <span class="ruby-value str">&quot;tmp.pot&quot;</span>) +132: <span class="ruby-identifier">rgettext</span>(<span class="ruby-identifier">files</span>, <span class="ruby-identifier">refpot</span>) +133: <span class="ruby-identifier">msgmerge_all</span>(<span class="ruby-identifier">textdomain</span>, <span class="ruby-identifier">app_version</span>, <span class="ruby-identifier">po_root</span>, <span class="ruby-identifier">refpot</span>) +134: <span class="ruby-constant">File</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">refpot</span>) +135: <span class="ruby-keyword kw">end</span> </pre> </div> </div> </div> \ No newline at end of file