home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _7250abee5378eeddd074a1b0cc070b58 < prev    next >
Encoding:
Text File  |  2000-03-23  |  3.9 KB  |  116 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>SGMLS::Output - Stack-based Output Procedures</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> SGMLS::Output - Stack-based Output Procedures</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="#author and copyright">AUTHOR AND COPYRIGHT</A></LI>
  26.     <LI><A HREF="#see also:">SEE ALSO:</A></LI>
  27. </UL>
  28. <!-- INDEX END -->
  29.  
  30. <HR>
  31. <P>
  32. <H1><A NAME="name">NAME</A></H1>
  33. <P>SGMLS::Output - Stack-based Output Procedures</P>
  34. <P>
  35. <HR>
  36. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  37. <UL>
  38. <LI>Windows</LI>
  39. </UL>
  40. <HR>
  41. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  42. <PRE>
  43.   use SGMLS::Output;</PRE>
  44. <P>To print a string to the current output destination:</P>
  45. <PRE>
  46.   output($data);</PRE>
  47. <P>To push a new output level to the filehandle DATA:</P>
  48. <PRE>
  49.   push_output('handle',DATA);</PRE>
  50. <P>To push a new output level to the file ``foo.data'' (which will be
  51. opened and closed automatically):</P>
  52. <PRE>
  53.   push_output('file','foo.data');</PRE>
  54. <P>To push a new output level to a pipe to the shell command ``sort'':</P>
  55. <PRE>
  56.   push_output('pipe','sort');</PRE>
  57. <P>To push a new output level <EM>appending</EM> to the file ``foo.data'':</P>
  58. <PRE>
  59.   push_output('append','foo.data');</PRE>
  60. <P>To push a new output level to an empty string:</P>
  61. <PRE>
  62.   push_output('string');</PRE>
  63. <P>To push a new output level appending to the string ``David is '':</P>
  64. <PRE>
  65.   push_output('string',"David is ");</PRE>
  66. <P>To push a new output level to The Great Beyond:</P>
  67. <PRE>
  68.   push_output('nul');</PRE>
  69. <P>To revert to the previous output level:</P>
  70. <PRE>
  71.   pop_output();</PRE>
  72. <P>To revert to the previous output level, returning the contents of an
  73. output string:</P>
  74. <PRE>
  75.   $data = pop_output();</PRE>
  76. <P>
  77. <HR>
  78. <H1><A NAME="description">DESCRIPTION</A></H1>
  79. <P>This library allows redirectable, stack-based output to files, pipes,
  80. handles, strings, or nul.  It is especially useful for packages like
  81. <A HREF="../../../site/lib/SGMLS.html">the SGMLS manpage</A>, since handlers for individual <STRONG>SGML</STRONG> elements can
  82. temporarily change and restore the default output destination.  It is
  83. also particularly useful for capturing the contents of an element (and
  84. its sub-elements) in a string.</P>
  85. <P>Example:</P>
  86. <PRE>
  87.   sgmls('<title>', sub{ push_output('string'); });
  88.   sgmls('</title>', sub{ $title = pop_output(); });</PRE>
  89. <P>In between, anything sent to <STRONG>output</STRONG> (such as CDATA) will be
  90. accumulated in the string returned from <STRONG>pop_output()</STRONG>.</P>
  91. <P>Example:</P>
  92. <PRE>
  93.   sgmls('<tei.header>', sub { push_output('nul'); });
  94.   sgmls('</tei.header>', sub { pop_output(); });</PRE>
  95. <P>All output will be ignored until the header has finished.</P>
  96. <P>
  97. <HR>
  98. <H1><A NAME="author and copyright">AUTHOR AND COPYRIGHT</A></H1>
  99. <P>Copyright 1994 and 1995 by David Megginson,
  100. <CODE>dmeggins@aix1.uottawa.ca</CODE>.  Distributed under the terms of the Gnu
  101. General Public License (version 2, 1991) -- see the file <CODE>COPYING</CODE>
  102. which is included in the <STRONG>SGMLS.pm</STRONG> distribution.</P>
  103. <P>
  104. <HR>
  105. <H1><A NAME="see also:">SEE ALSO:</A></H1>
  106. <P><A HREF="../../../site/lib/SGMLS.html">the SGMLS manpage</A>.</P>
  107. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  108. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  109. <STRONG><P CLASS=block> SGMLS::Output - Stack-based Output Procedures</P></STRONG>
  110. </TD></TR>
  111. </TABLE>
  112.  
  113. </BODY>
  114.  
  115. </HTML>
  116.