home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _06f401629c2beb82734985a92d5b5662 < prev    next >
Text File  |  2000-03-23  |  3KB  |  97 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>HTML::Entities - Encode or decode strings with HTML entities</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> HTML::Entities - Encode or decode strings with HTML entities</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="#copyright">COPYRIGHT</A></LI>
  26. </UL>
  27. <!-- INDEX END -->
  28.  
  29. <HR>
  30. <P>
  31. <H1><A NAME="name">NAME</A></H1>
  32. <P>HTML::Entities - Encode or decode strings with HTML entities</P>
  33. <P>
  34. <HR>
  35. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  36. <UL>
  37. <LI>Linux</LI>
  38. <LI>Solaris</LI>
  39. <LI>Windows</LI>
  40. </UL>
  41. <HR>
  42. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  43. <PRE>
  44.  use HTML::Entities;</PRE>
  45. <PRE>
  46.  $a = "V&aring;re norske tegn b&oslash;r &#230res";
  47.  decode_entities($a);
  48.  encode_entities($a, "\200-\377");</PRE>
  49. <P>
  50. <HR>
  51. <H1><A NAME="description">DESCRIPTION</A></H1>
  52. <P>This module deals with encoding and decoding of strings with HTML
  53. character entites.  The module provide the following functions:</P>
  54. <DL>
  55. <DT><STRONG><A NAME="item_decode_entities"><CODE>decode_entities($string)</CODE></A></STRONG><BR>
  56. <DD>
  57. This routine replaces HTML entities found in the $string with the
  58. corresponding ISO-8859/1 character.  Unrecognized entities are left
  59. alone.
  60. <P></P>
  61. <DT><STRONG><A NAME="item_endode_entities">endode_entities($string, [$unsafe_chars])</A></STRONG><BR>
  62. <DD>
  63. This routine replaces unsafe characters in $string with their entity
  64. representation.  A second argument can be given to specify which
  65. characters to concider as unsafe.  The default set of characters to
  66. expand are control chars, high-bit chars and the '<', '&', '>' and '``'
  67. character.
  68. <P></P></DL>
  69. <P>Both routines modify the string passed in as the first argument if
  70. called in void context.  In scalar and array context the encoded or
  71. decoded string is returned (and the argument string is left
  72. unchanged).</P>
  73. <P>If you prefer not to import these routines into your namespace you can
  74. call them as:</P>
  75. <PRE>
  76.   use HTML::Entities ();
  77.   $encoded = HTML::Entities::encode($a);
  78.   $decoded = HTML::Entities::decode($a);</PRE>
  79. <P>The module can also export the %char2entity and the %entity2char
  80. hashes which contains the mapping from all characters to the
  81. corresponding entities.</P>
  82. <P>
  83. <HR>
  84. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  85. <P>Copyright 1995-1998 Gisle Aas. All rights reserved.</P>
  86. <P>This library is free software; you can redistribute it and/or
  87. modify it under the same terms as Perl itself.</P>
  88. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  89. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  90. <STRONG><P CLASS=block> HTML::Entities - Encode or decode strings with HTML entities</P></STRONG>
  91. </TD></TR>
  92. </TABLE>
  93.  
  94. </BODY>
  95.  
  96. </HTML>
  97.