home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _0e9286d9b3c37f71751a83c5e0c799c2 < prev    next >
Text File  |  2000-03-23  |  4KB  |  96 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>I18N::Collate - compare 8-bit scalar data according to the current locale</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> I18N::Collate - compare 8-bit scalar data according to the current locale</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. </UL>
  26. <!-- INDEX END -->
  27.  
  28. <HR>
  29. <P>
  30. <H1><A NAME="name">NAME</A></H1>
  31. <P>I18N::Collate - compare 8-bit scalar data according to the current locale</P>
  32. <PRE>
  33.   ***</PRE>
  34. <PRE>
  35.   WARNING: starting from the Perl version 5.003_06
  36.   the I18N::Collate interface for comparing 8-bit scalar data
  37.   according to the current locale</PRE>
  38. <PRE>
  39.         HAS BEEN DEPRECATED</PRE>
  40. <PRE>
  41.   That is, please do not use it anymore for any new applications
  42.   and please migrate the old applications away from it because its
  43.   functionality was integrated into the Perl core language in the
  44.   release 5.003_06.</PRE>
  45. <PRE>
  46.   See the <A HREF="../../lib/Pod/perllocale.html">perllocale</A> manual page for further information.</PRE>
  47. <PRE>
  48.   ***</PRE>
  49. <P>
  50. <HR>
  51. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  52. <UL>
  53. <LI>Linux</LI>
  54. <LI>Solaris</LI>
  55. <LI>Windows</LI>
  56. </UL>
  57. <HR>
  58. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  59. <PRE>
  60.     use I18N::Collate;
  61.     setlocale(LC_COLLATE, 'locale-of-your-choice'); 
  62.     $s1 = new I18N::Collate "scalar_data_1";
  63.     $s2 = new I18N::Collate "scalar_data_2";</PRE>
  64. <P>
  65. <HR>
  66. <H1><A NAME="description">DESCRIPTION</A></H1>
  67. <P>This module provides you with objects that will collate 
  68. according to your national character set, provided that the 
  69. POSIX <CODE>setlocale()</CODE> function is supported on your system.</P>
  70. <P>You can compare $s1 and $s2 above with</P>
  71. <PRE>
  72.     $s1 le $s2</PRE>
  73. <P>to extract the data itself, you'll need a dereference: $$s1</P>
  74. <P>This module uses POSIX::setlocale(). The basic collation conversion is
  75. done by <CODE>strxfrm()</CODE> which terminates at NUL characters being a decent C
  76. routine.  <CODE>collate_xfrm()</CODE> handles embedded NUL characters gracefully.</P>
  77. <P>The available locales depend on your operating system; try whether
  78. <CODE>locale -a</CODE> shows them or man pages for ``locale'' or ``nlsinfo'' or the
  79. direct approach <CODE>ls /usr/lib/nls/loc</CODE> or <CODE>ls /usr/lib/nls</CODE> or
  80. <CODE>ls /usr/lib/locale</CODE>.  Not all the locales that your vendor supports
  81. are necessarily installed: please consult your operating system's
  82. documentation and possibly your local system administration.  The
  83. locale names are probably something like <CODE>xx_XX.(ISO)?8859-N</CODE> or
  84. <CODE>xx_XX.(ISO)?8859N</CODE>, for example <CODE>fr_CH.ISO8859-1</CODE> is the Swiss (CH)
  85. variant of French (fr), ISO Latin (8859) 1 (-1) which is the Western
  86. European character set.</P>
  87. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  88. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  89. <STRONG><P CLASS=block> I18N::Collate - compare 8-bit scalar data according to the current locale</P></STRONG>
  90. </TD></TR>
  91. </TABLE>
  92.  
  93. </BODY>
  94.  
  95. </HTML>
  96.