home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _679983a61846f146560bdeebe646e58f < prev    next >
Text File  |  2000-03-23  |  6KB  |  173 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Locale::Language - ISO two letter codes for language identification</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Locale::Language - ISO two letter codes for language identification</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#conversion routines">CONVERSION ROUTINES</A></LI>
  26.     <LI><A HREF="#query routines">QUERY ROUTINES</A></LI>
  27.     <LI><A HREF="#examples">EXAMPLES</A></LI>
  28.     <LI><A HREF="#known bugs and limitations">KNOWN BUGS AND LIMITATIONS</A></LI>
  29.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  30.     <LI><A HREF="#author">AUTHOR</A></LI>
  31.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  32. </UL>
  33. <!-- INDEX END -->
  34.  
  35. <HR>
  36. <P>
  37. <H1><A NAME="name">NAME</A></H1>
  38. <P>Locale::Language - ISO two letter codes for language identification (ISO 639)</P>
  39. <P>
  40. <HR>
  41. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  42. <UL>
  43. <LI>Linux</LI>
  44. <LI>Solaris</LI>
  45. <LI>Windows</LI>
  46. </UL>
  47. <HR>
  48. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  49. <PRE>
  50.     use Locale::Language;
  51. </PRE>
  52. <PRE>
  53.  
  54.     $lang = code2language('en');        # $lang gets 'English'
  55.     $code = language2code('French');    # $code gets 'fr'</PRE>
  56. <PRE>
  57.  
  58.     @codes   = all_language_codes();
  59.     @names   = all_language_names();</PRE>
  60. <P>
  61. <HR>
  62. <H1><A NAME="description">DESCRIPTION</A></H1>
  63. <P>The <CODE>Locale::Language</CODE> module provides access to the ISO two-letter
  64. codes for identifying languages, as defined in ISO 639. You can either
  65. access the codes via the <A HREF="#conversion routines">conversion routines</A> (described below),
  66. or with the two functions which return lists of all language codes or
  67. all language names.</P>
  68. <P>
  69. <HR>
  70. <H1><A NAME="conversion routines">CONVERSION ROUTINES</A></H1>
  71. <P>There are two conversion routines: <A HREF="#item_code2language"><CODE>code2language()</CODE></A> and <A HREF="#item_language2code"><CODE>language2code()</CODE></A>.</P>
  72. <DL>
  73. <DT><STRONG><A NAME="item_code2language"><CODE>code2language()</CODE></A></STRONG><BR>
  74. <DD>
  75. This function takes a two letter language code and returns a string
  76. which contains the name of the language identified. If the code is
  77. not a valid language code, as defined by ISO 639, then <A HREF="../../../lib/Pod/perlfunc.html#item_undef"><CODE>undef</CODE></A>
  78. will be returned.
  79. <PRE>
  80.     $lang = code2language($code);</PRE>
  81. <P></P>
  82. <DT><STRONG><A NAME="item_language2code"><CODE>language2code()</CODE></A></STRONG><BR>
  83. <DD>
  84. This function takes a language name and returns the corresponding
  85. two letter language code, if such exists.
  86. If the argument could not be identified as a language name,
  87. then <A HREF="../../../lib/Pod/perlfunc.html#item_undef"><CODE>undef</CODE></A> will be returned.
  88. <PRE>
  89.     $code = language2code('French');</PRE>
  90. <P>The case of the language name is not important.
  91. See the section <A HREF="#known bugs and limitations">KNOWN BUGS AND LIMITATIONS</A> below.</P>
  92. <P></P></DL>
  93. <P>
  94. <HR>
  95. <H1><A NAME="query routines">QUERY ROUTINES</A></H1>
  96. <P>There are two function which can be used to obtain a list of all
  97. language codes, or all language names:</P>
  98. <DL>
  99. <DT><STRONG><A NAME="item_all_language_codes"><CODE>all_language_codes()</CODE></A></STRONG><BR>
  100. <DD>
  101. Returns a list of all two-letter language codes.
  102. The codes are guaranteed to be all lower-case,
  103. and not in any particular order.
  104. <P></P>
  105. <DT><STRONG><A NAME="item_all_language_names"><CODE>all_language_names()</CODE></A></STRONG><BR>
  106. <DD>
  107. Returns a list of all language names for which there is a corresponding
  108. two-letter language code. The names are capitalised, and not returned
  109. in any particular order.
  110. <P></P></DL>
  111. <P>
  112. <HR>
  113. <H1><A NAME="examples">EXAMPLES</A></H1>
  114. <P>The following example illustrates use of the <A HREF="#item_code2language"><CODE>code2language()</CODE></A> function.
  115. The user is prompted for a language code, and then told the corresponding
  116. language name:</P>
  117. <PRE>
  118.     $| = 1;    # turn off buffering
  119. </PRE>
  120. <PRE>
  121.  
  122.     print "Enter language code: ";
  123.     chop($code = <STDIN>);
  124.     $lang = code2language($code);
  125.     if (defined $lang)
  126.     {
  127.         print "$code = $lang\n";
  128.     }
  129.     else
  130.     {
  131.         print "'$code' is not a valid language code!\n";
  132.     }</PRE>
  133. <P>
  134. <HR>
  135. <H1><A NAME="known bugs and limitations">KNOWN BUGS AND LIMITATIONS</A></H1>
  136. <UL>
  137. <LI>
  138. In the current implementation, all data is read in when the
  139. module is loaded, and then held in memory.
  140. A lazy implementation would be more memory friendly.
  141. <P></P></UL>
  142. <P>
  143. <HR>
  144. <H1><A NAME="see also">SEE ALSO</A></H1>
  145. <DL>
  146. <DT><STRONG><A NAME="item_Locale%3A%3ACountry">Locale::Country</A></STRONG><BR>
  147. <DD>
  148. ISO two letter codes for identification of country (ISO 3166).
  149. <P></P>
  150. <DT><STRONG><A NAME="item_1988">ISO 639:1988 (E/F)</A></STRONG><BR>
  151. <DD>
  152. Code for the representation of names of languages.
  153. <P></P></DL>
  154. <P>
  155. <HR>
  156. <H1><A NAME="author">AUTHOR</A></H1>
  157. <P>Neil Bowers <<A HREF="mailto:neilb@cre.canon.co.uk">neilb@cre.canon.co.uk</A>></P>
  158. <P>
  159. <HR>
  160. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  161. <P>Copyright (c) 1997 Canon Research Centre Europe (CRE).</P>
  162. <P>This module is free software; you can redistribute it and/or
  163. modify it under the same terms as Perl itself.</P>
  164. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  165. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  166. <STRONG><P CLASS=block> Locale::Language - ISO two letter codes for language identification</P></STRONG>
  167. </TD></TR>
  168. </TABLE>
  169.  
  170. </BODY>
  171.  
  172. </HTML>
  173.