home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _ef25181950fac346c35bd9a566abfbe2 < prev    next >
Text File  |  2000-03-23  |  4KB  |  115 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Win32::Mutex - Use Win32 mutex objects from Perl</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> Win32::Mutex - Use Win32 mutex objects from Perl</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.     <UL>
  26.  
  27.         <LI><A HREF="#methods">Methods</A></LI>
  28.         <LI><A HREF="#deprecated functions and methods">Deprecated Functions and Methods</A></LI>
  29.     </UL>
  30.  
  31.     <LI><A HREF="#author">AUTHOR</A></LI>
  32. </UL>
  33. <!-- INDEX END -->
  34.  
  35. <HR>
  36. <P>
  37. <H1><A NAME="name">NAME</A></H1>
  38. <P>Win32::Mutex - Use Win32 mutex objects from Perl</P>
  39. <P>
  40. <HR>
  41. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  42. <UL>
  43. <LI>Windows</LI>
  44. </UL>
  45. <HR>
  46. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  47. <PRE>
  48.         require Win32::Mutex;</PRE>
  49. <PRE>
  50.         $mutex = Win32::Mutex->new($initial,$name);
  51.         $mutex->wait;</PRE>
  52. <P>
  53. <HR>
  54. <H1><A NAME="description">DESCRIPTION</A></H1>
  55. <P>This module allows access to the Win32 mutex objects.  The <A HREF="#item_wait"><CODE>wait</CODE></A>
  56. method and <CODE>wait_all</CODE> & <CODE>wait_any</CODE> functions are inherited from the
  57. <A HREF="#win32::ipc">Win32::IPC</A> module.</P>
  58. <P>
  59. <H2><A NAME="methods">Methods</A></H2>
  60. <DL>
  61. <DT><STRONG><A NAME="item_new">$mutex = Win32::Mutex->new([$initial, [$name]])</A></STRONG><BR>
  62. <DD>
  63. Constructor for a new mutex object.  If <CODE>$initial</CODE> is true, requests
  64. immediate ownership of the mutex (default false).  If <CODE>$name</CODE> is
  65. omitted, creates an unnamed mutex object.
  66. <P>If <CODE>$name</CODE> signifies an existing mutex object, then <CODE>$initial</CODE> is
  67. ignored and the object is opened.</P>
  68. <P></P>
  69. <DT><STRONG><A NAME="item_open">$mutex = Win32::Mutex-><CODE>open($name)</CODE></A></STRONG><BR>
  70. <DD>
  71. Constructor for opening an existing mutex object.
  72. <P></P>
  73. <DT><STRONG><A NAME="item_release">$mutex->release</A></STRONG><BR>
  74. <DD>
  75. Release ownership of a <CODE>$mutex</CODE>.  You should have obtained ownership
  76. of the mutex through <A HREF="#item_new"><CODE>new</CODE></A> or one of the wait functions.  Returns
  77. true if successful.
  78. <P></P>
  79. <DT><STRONG><A NAME="item_wait">$mutex-><CODE>wait([$timeout])</CODE></A></STRONG><BR>
  80. <DD>
  81. Wait for ownership of <CODE>$mutex</CODE>.  See <A HREF="#win32::ipc">Win32::IPC</A>.
  82. <P></P></DL>
  83. <P>
  84. <H2><A NAME="deprecated functions and methods">Deprecated Functions and Methods</A></H2>
  85. <P><STRONG>Win32::Mutex</STRONG> still supports the ActiveWare syntax, but its use is
  86. deprecated.</P>
  87. <DL>
  88. <DT><STRONG><A NAME="item_Create"><CODE>Create($MutObj,$Initial,$Name)</CODE></A></STRONG><BR>
  89. <DD>
  90. Use <A HREF="#item_new"><CODE>$MutObj = Win32::Mutex->new($Initial,$Name)</CODE></A> instead.
  91. <P></P>
  92. <DT><STRONG><A NAME="item_Open"><CODE>Open($MutObj,$Name)</CODE></A></STRONG><BR>
  93. <DD>
  94. Use <A HREF="#item_open"><CODE>$MutObj = Win32::Mutex->open($Name)</CODE></A> instead.
  95. <P></P>
  96. <DT><STRONG><A NAME="item_Release">$MutObj-><CODE>Release()</CODE></A></STRONG><BR>
  97. <DD>
  98. Use <A HREF="#item_release"><CODE>$MutObj->release</CODE></A> instead.
  99. <P></P></DL>
  100. <P>
  101. <HR>
  102. <H1><A NAME="author">AUTHOR</A></H1>
  103. <P>Christopher J. Madsen <<EM><A HREF="mailto:chris_madsen@geocities.com">chris_madsen@geocities.com</A></EM>></P>
  104. <P>Loosely based on the original module by ActiveWare Internet Corp.,
  105. <EM><A HREF="http://www.ActiveWare.com">http://www.ActiveWare.com</A></EM></P>
  106. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  107. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  108. <STRONG><P CLASS=block> Win32::Mutex - Use Win32 mutex objects from Perl</P></STRONG>
  109. </TD></TR>
  110. </TABLE>
  111.  
  112. </BODY>
  113.  
  114. </HTML>
  115.