home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _0e8ea023fbc2ccf4935622e3fbf74e47 < prev    next >
Text File  |  2000-03-23  |  4KB  |  120 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>IO::Poll - Object interface to system poll call</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> IO::Poll - Object interface to system poll call</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="#methods">METHODS</A></LI>
  26.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  27.     <LI><A HREF="#author">AUTHOR</A></LI>
  28.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  29. </UL>
  30. <!-- INDEX END -->
  31.  
  32. <HR>
  33. <P>
  34. <H1><A NAME="name">NAME</A></H1>
  35. <P>IO::Poll - Object interface to system poll call</P>
  36. <P>
  37. <HR>
  38. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  39. <UL>
  40. <LI>Linux</LI>
  41. <LI>Solaris</LI>
  42. <LI>Windows</LI>
  43. </UL>
  44. <HR>
  45. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  46. <PRE>
  47.     use IO::Poll qw(POLLRDNORM POLLWRNORM POLLIN POLLHUP);</PRE>
  48. <PRE>
  49.     $poll = new IO::Poll;</PRE>
  50. <PRE>
  51.     $poll->mask($input_handle => POLLRDNORM | POLLIN | POLLHUP);
  52.     $poll->mask($output_handle => POLLWRNORM);</PRE>
  53. <PRE>
  54.     $poll->poll($timeout);</PRE>
  55. <PRE>
  56.     $ev = $poll->events($input);</PRE>
  57. <P>
  58. <HR>
  59. <H1><A NAME="description">DESCRIPTION</A></H1>
  60. <P><CODE>IO::Poll</CODE> is a simple interface to the system level poll routine.</P>
  61. <P>
  62. <HR>
  63. <H1><A NAME="methods">METHODS</A></H1>
  64. <DL>
  65. <DT><STRONG><A NAME="item_mask">mask ( IO [, EVENT_MASK ] )</A></STRONG><BR>
  66. <DD>
  67. If EVENT_MASK is given, then, if EVENT_MASK is non-zero, IO is added to the
  68. list of file descriptors and the next call to poll will check for
  69. any event specified in EVENT_MASK. If EVENT_MASK is zero then IO will be
  70. removed from the list of file descriptors.
  71. <P>If EVENT_MASK is not given then the return value will be the current
  72. event mask value for IO.</P>
  73. <P></P>
  74. <DT><STRONG><A NAME="item_poll">poll ( [ TIMEOUT ] )</A></STRONG><BR>
  75. <DD>
  76. Call the system level poll routine. If TIMEOUT is not specified then the
  77. call will block. Returns the number of handles which had events
  78. happen, or -1 on error.
  79. <P></P>
  80. <DT><STRONG><A NAME="item_events">events ( IO )</A></STRONG><BR>
  81. <DD>
  82. Returns the event mask which represents the events that happend on IO
  83. during the last call to <A HREF="#item_poll"><CODE>poll</CODE></A>.
  84. <P></P>
  85. <DT><STRONG><A NAME="item_remove">remove ( IO )</A></STRONG><BR>
  86. <DD>
  87. Remove IO from the list of file descriptors for the next poll.
  88. <P></P>
  89. <DT><STRONG><A NAME="item_handles">handles( [ EVENT_MASK ] )</A></STRONG><BR>
  90. <DD>
  91. Returns a list of handles. If EVENT_MASK is not given then a list of all
  92. handles known will be returned. If EVENT_MASK is given then a list
  93. of handles will be returned which had one of the events specified by
  94. EVENT_MASK happen during the last call ti <A HREF="#item_poll"><CODE>poll</CODE></A>
  95. <P></P></DL>
  96. <P>
  97. <HR>
  98. <H1><A NAME="see also">SEE ALSO</A></H1>
  99. <P><A HREF="#item_poll">poll(2)</A>, <A HREF="../../lib/IO/Handle.html">the IO::Handle manpage</A>, <A HREF="../../lib/IO/Select.html">the IO::Select manpage</A></P>
  100. <P>
  101. <HR>
  102. <H1><A NAME="author">AUTHOR</A></H1>
  103. <P>Graham Barr. Currently maintained by the Perl Porters.  Please report all
  104. bugs to <<A HREF="mailto:perl5-porters@perl.org">perl5-porters@perl.org</A>>.</P>
  105. <P>
  106. <HR>
  107. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  108. <P>Copyright (c) 1997-8 Graham Barr <<A HREF="mailto:gbarr@pobox.com">gbarr@pobox.com</A>>. All rights reserved.
  109. This program is free software; you can redistribute it and/or
  110. modify it under the same terms as Perl itself.</P>
  111. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  112. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  113. <STRONG><P CLASS=block> IO::Poll - Object interface to system poll call</P></STRONG>
  114. </TD></TR>
  115. </TABLE>
  116.  
  117. </BODY>
  118.  
  119. </HTML>
  120.