home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _f1d5c7f89d2e52302965616515e2b2e3 < prev    next >
Text File  |  2000-03-23  |  4KB  |  92 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>open - perl pragma to set default disciplines for input and output</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> open - perl pragma to set default disciplines for input and output</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="#unimplemented functionality">UNIMPLEMENTED FUNCTIONALITY</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>open - perl pragma to set default disciplines for input and output</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 open IN => ":crlf", OUT => ":raw";</PRE>
  46. <P>
  47. <HR>
  48. <H1><A NAME="description">DESCRIPTION</A></H1>
  49. <P>The open pragma is used to declare one or more default disciplines for
  50. I/O operations.  Any <A HREF="../lib/Pod/perlfunc.html#item_open"><CODE>open()</CODE></A> and <A HREF="../lib/Pod/perlfunc.html#item_readpipe"><CODE>readpipe()</CODE></A> (aka qx//) operators found
  51. within the lexical scope of this pragma will use the declared defaults.
  52. Neither <A HREF="../lib/Pod/perlfunc.html#item_open"><CODE>open()</CODE></A> with an explicit set of disciplines, nor <A HREF="../lib/Pod/perlfunc.html#item_sysopen"><CODE>sysopen()</CODE></A> are
  53. influenced by this pragma.</P>
  54. <P>Only the two pseudo-disciplines ``:raw'' and ``:crlf'' are currently
  55. available.</P>
  56. <P>The ``:raw'' discipline corresponds to ``binary mode'' and the ``:crlf''
  57. discipline corresponds to ``text mode'' on platforms that distinguish
  58. between the two modes when opening files (which is many DOS-like
  59. platforms, including Windows).  These two disciplines are currently
  60. no-ops on platforms where <A HREF="../lib/Pod/perlfunc.html#item_binmode"><CODE>binmode()</CODE></A> is a no-op, but will be
  61. supported everywhere in future.</P>
  62. <P>
  63. <HR>
  64. <H1><A NAME="unimplemented functionality">UNIMPLEMENTED FUNCTIONALITY</A></H1>
  65. <P>Full-fledged support for I/O disciplines is currently unimplemented.
  66. When they are eventually supported, this pragma will serve as one of
  67. the interfaces to declare default disciplines for all I/O.</P>
  68. <P>In future, any default disciplines declared by this pragma will be
  69. available by the special discipline name ``:DEFAULT'', and could be used
  70. within handle constructors that allow disciplines to be specified.
  71. This would make it possible to stack new disciplines over the default
  72. ones.</P>
  73. <PRE>
  74.     open FH, "<:para :DEFAULT", $file or die "can't open $file: $!";</PRE>
  75. <P>Socket and directory handles will also support disciplines in
  76. future.</P>
  77. <P>Full support for I/O disciplines will enable all of the supported
  78. disciplines to work on all platforms.</P>
  79. <P>
  80. <HR>
  81. <H1><A NAME="see also">SEE ALSO</A></H1>
  82. <P><A HREF="../lib/Pod/perlfunc.html#binmode">binmode in the perlfunc manpage</A>, <A HREF="../lib/Pod/perlfunc.html#open">open in the perlfunc manpage</A>, <A HREF="../lib/Pod/perlunicode.html">the perlunicode manpage</A></P>
  83. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  84. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  85. <STRONG><P CLASS=block> open - perl pragma to set default disciplines for input and output</P></STRONG>
  86. </TD></TR>
  87. </TABLE>
  88.  
  89. </BODY>
  90.  
  91. </HTML>
  92.