home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _444f756d25e6fbb037530518adba6570 < prev    next >
Text File  |  2000-03-23  |  3KB  |  102 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>URI::data - URI that contain immediate data</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> URI::data - URI that contain immediate data</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="#see also">SEE ALSO</A></LI>
  26.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  27. </UL>
  28. <!-- INDEX END -->
  29.  
  30. <HR>
  31. <P>
  32. <H1><A NAME="name">NAME</A></H1>
  33. <P>URI::data - URI that contain immediate data</P>
  34. <P>
  35. <HR>
  36. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  37. <UL>
  38. <LI>Linux</LI>
  39. <LI>Solaris</LI>
  40. <LI>Windows</LI>
  41. </UL>
  42. <HR>
  43. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  44. <PRE>
  45.  use URI;</PRE>
  46. <PRE>
  47.  $u = URI->new("data:");
  48.  $u->media_type("image/gif");
  49.  $u->data(scalar(`cat camel.gif`));
  50.  print "$u\n";
  51.  open(XV, "|xv -") and print XV $u->data;</PRE>
  52. <P>
  53. <HR>
  54. <H1><A NAME="description">DESCRIPTION</A></H1>
  55. <P>The <CODE>URI::data</CODE> class supports <CODE>URI</CODE> objects belonging to the <EM>data</EM>
  56. URI scheme.  The <EM>data</EM> URI scheme is specified in RFC 2397.  It
  57. allows inclusion of small data items as ``immediate'' data, as if it had
  58. been included externally.  Examples:</P>
  59. <PRE>
  60.   data:,Perl%20is%20good</PRE>
  61. <PRE>
  62.   data:image/gif;base64,R0lGODdhIAAgAIAAAAAAAPj8+CwAAAAAI
  63.     AAgAAAClYyPqcu9AJyCjtIKc5w5xP14xgeO2tlY3nWcajmZZdeJcG
  64.     Kxrmimms1KMTa1Wg8UROx4MNUq1HrycMjHT9b6xKxaFLM6VRKzI+p
  65.     KS9XtXpcbdun6uWVxJXA8pNPkdkkxhxc21LZHFOgD2KMoQXa2KMWI
  66.     JtnE2KizVUkYJVZZ1nczBxXlFopZBtoJ2diXGdNUymmJdFMAADs=</PRE>
  67. <P><CODE>URI</CODE> objects belonging to the data scheme support the common methods
  68. (described in <A HREF="../../../site/lib/URI.html">the URI manpage</A>) and the following two scheme specific methods:</P>
  69. <DL>
  70. <DT><STRONG><A NAME="item_media_type">$uri->media_type( [$new_media_type] )</A></STRONG><BR>
  71. <DD>
  72. This method can be used to get or set the media type specified in the
  73. URI.  If no media type is specified, then the default
  74. <CODE>"text/plain;charset=US-ASCII"</CODE> is returned.
  75. <P></P>
  76. <DT><STRONG><A NAME="item_data">$uri->data( [$new_data] )</A></STRONG><BR>
  77. <DD>
  78. This method can be used to get or set the data contained in the URI.
  79. The data is passed unescaped (in binary form).  The decision about
  80. whether to base64 encode the data in the URI is taken automatically
  81. based on what encoding produces the shortest URI string.
  82. <P></P></DL>
  83. <P>
  84. <HR>
  85. <H1><A NAME="see also">SEE ALSO</A></H1>
  86. <P><A HREF="../../../site/lib/URI.html">the URI manpage</A></P>
  87. <P>
  88. <HR>
  89. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  90. <P>Copyright 1995-1998 Gisle Aas.</P>
  91. <P>This library is free software; you can redistribute it and/or
  92. modify it under the same terms as Perl itself.</P>
  93. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  94. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  95. <STRONG><P CLASS=block> URI::data - URI that contain immediate data</P></STRONG>
  96. </TD></TR>
  97. </TABLE>
  98.  
  99. </BODY>
  100.  
  101. </HTML>
  102.