PageRenderTime 26ms CodeModel.GetById 20ms RepoModel.GetById 0ms app.codeStats 0ms

/php/function.inotify-init.html

https://bitbucket.org/thncr/manuals
HTML | 93 lines | 80 code | 13 blank | 0 comment | 0 complexity | 948601f0c6dfbcea688f42d783f66e4d MD5 | raw file
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    2. 

  2. <html>
    3. 

  3.  <head>
    4. 

  4.   <meta http-equiv="content-type" content="text/html; charset=UTF-8">
    5. 

  5.   <title>Initialize an inotify instance</title>
    6. 

  6. 

  7.  </head>
    8. 

  8.  <body><div class="manualnavbar" style="text-align: center;">
    9. 

  9.  <div class="prev" style="text-align: left; float: left;"><a href="function.inotify-add-watch.html">inotify_add_watch</a></div>
    10. 

  10.  <div class="next" style="text-align: right; float: right;"><a href="function.inotify-queue-len.html">inotify_queue_len</a></div>
    11. 

  11.  <div class="up"><a href="ref.inotify.html">Inotify 函数</a></div>
    12. 

  12.  <div class="home"><a href="index.html">PHP Manual</a></div>
    13. 

  13. </div><hr /><div id="function.inotify-init" class="refentry">
    14. 

  14.  <div class="refnamediv">
    15. 

  15.   <h1 class="refname">inotify_init</h1>
    16. 

  16.   <p class="verinfo">(PECL inotify &gt;= 0.1.2)</p><p class="refpurpose"><span class="refname">inotify_init</span> &mdash; <span class="dc-title">Initialize an inotify instance</span></p>
    17. 

  17. 

  18.  </div>
    19. 

  19.  
    20. 

  20.  <div class="refsect1 description" id="refsect1-function.inotify-init-description">
    21. 

  21.   <h3 class="title">说明</h3>
    22. 

  22.   <div class="methodsynopsis dc-description">
    23. 

  23.    <span class="type">resource</span> <span class="methodname"><strong>inotify_init</strong></span>
    24. 

  24.     ( <span class="methodparam">void</span>
    25. 

  25.    )</div>
    26. 

  26. 

  27.   <p class="para rdfs-comment">
    28. 

  28.    Initialize an inotify instance for use with
    29. 

  29.     <span class="function"><a href="function.inotify-add-watch.html" class="function">inotify_add_watch()</a></span>
    30. 

  30.   </p>
    31. 

  31.  </div>
    32. 

  32. 

  33.  
    34. 

  34.  <div class="refsect1 returnvalues" id="refsect1-function.inotify-init-returnvalues">
    35. 

  35.   <h3 class="title">返回值</h3>
    36. 

  36.   <p class="para">
    37. 

  37.    A stream resource or <strong><code>FALSE</code></strong> on error.
    38. 

  38.   </p>
    39. 

  39.  </div>
    40. 

  40. 

  41.  
    42. 

  42.  <div class="refsect1 examples" id="refsect1-function.inotify-init-examples">
    43. 

  43.   <h3 class="title">范例</h3>
    44. 

  44.   <p class="para">
    45. 

  45.    <div class="example" id="inotify-init.example.basic">
    46. 

  46.     <p><strong>Example #1 Example usage of inotify</strong></p>
    47. 

  47.     <div class="example-contents">
    48. 

  48. <div class="phpcode"><code><span style="color: #000000">
    49. 

  49. <span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">//&nbsp;Open&nbsp;an&nbsp;inotify&nbsp;instance<br /></span><span style="color: #0000BB">$fd&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">inotify_init</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">//&nbsp;Watch&nbsp;__FILE__&nbsp;for&nbsp;metadata&nbsp;changes&nbsp;(e.g.&nbsp;mtime)<br /></span><span style="color: #0000BB">$watch_descriptor&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">inotify_add_watch</span><span style="color: #007700">(</span><span style="color: #0000BB">$fd</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">__FILE__</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">IN_ATTRIB</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;generate&nbsp;an&nbsp;event<br /></span><span style="color: #0000BB">touch</span><span style="color: #007700">(</span><span style="color: #0000BB">__FILE__</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;Read&nbsp;events<br /></span><span style="color: #0000BB">$events&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">inotify_read</span><span style="color: #007700">(</span><span style="color: #0000BB">$fd</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$events</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;The&nbsp;following&nbsp;methods&nbsp;allows&nbsp;to&nbsp;use&nbsp;inotify&nbsp;functions&nbsp;without&nbsp;blocking&nbsp;on&nbsp;inotify_read():<br /><br />//&nbsp;-&nbsp;Using&nbsp;stream_select()&nbsp;on&nbsp;$fd:<br /></span><span style="color: #0000BB">$read&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #0000BB">$fd</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$write&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">null</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$except&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">null</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">stream_select</span><span style="color: #007700">(</span><span style="color: #0000BB">$read</span><span style="color: #007700">,</span><span style="color: #0000BB">$write</span><span style="color: #007700">,</span><span style="color: #0000BB">$except</span><span style="color: #007700">,</span><span style="color: #0000BB">0</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;-&nbsp;Using&nbsp;stream_set_blocking()&nbsp;on&nbsp;$fd<br /></span><span style="color: #0000BB">stream_set_blocking</span><span style="color: #007700">(</span><span style="color: #0000BB">$fd</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">inotify_read</span><span style="color: #007700">(</span><span style="color: #0000BB">$fd</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;Does&nbsp;no&nbsp;block,&nbsp;and&nbsp;return&nbsp;false&nbsp;if&nbsp;no&nbsp;events&nbsp;are&nbsp;pending<br /><br />//&nbsp;-&nbsp;Using&nbsp;inotify_queue_len()&nbsp;to&nbsp;check&nbsp;if&nbsp;event&nbsp;queue&nbsp;is&nbsp;not&nbsp;empty<br /></span><span style="color: #0000BB">$queue_len&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">inotify_queue_len</span><span style="color: #007700">(</span><span style="color: #0000BB">$fd</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;If&nbsp;&gt;&nbsp;0,&nbsp;inotify_read()&nbsp;will&nbsp;not&nbsp;block<br /><br />//&nbsp;Stop&nbsp;watching&nbsp;__FILE__&nbsp;for&nbsp;metadata&nbsp;changes<br /></span><span style="color: #0000BB">inotify_rm_watch</span><span style="color: #007700">(</span><span style="color: #0000BB">$fd</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$watch_descriptor</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;Close&nbsp;the&nbsp;inotify&nbsp;instance<br />//&nbsp;This&nbsp;may&nbsp;have&nbsp;closed&nbsp;all&nbsp;watches&nbsp;if&nbsp;this&nbsp;was&nbsp;not&nbsp;already&nbsp;done<br /></span><span style="color: #0000BB">fclose</span><span style="color: #007700">(</span><span style="color: #0000BB">$fd</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span>
    50. 

  50. </span>
    51. 

  51. </code></div>
    52. 

  52.     </div>
    53. 

  53. 

  54.     <div class="example-contents"><p>以上例程的输出类似于：</p></div>
    55. 

  55.     <div class="example-contents screen">
    56. 

  56. <div class="cdata"><pre>
    57. 

  57. array(
    58. 

  58.   array(
    59. 

  59.     &#039;wd&#039; =&gt; 1,     // Equals $watch_descriptor
    60. 

  60.     &#039;mask&#039; =&gt; 4,   // IN_ATTRIB bit is set
    61. 

  61.     &#039;cookie&#039; =&gt; 0, // unique id to connect related events (e.g. 
    62. 

  62.                    // IN_MOVE_FROM and IN_MOVE_TO events)
    63. 

  63.     &#039;name&#039; =&gt; &#039;&#039;,  // the name of a file (e.g. if we monitored changes
    64. 

  64.                    // in a directory)
    65. 

  65.   ),
    66. 

  66. );
    67. 

  67. </pre></div>
    68. 

  68.     </div>
    69. 

  69.    </div>
    70. 

  70.   </p>
    71. 

  71.  </div>
    72. 

  72. 

  73.  
    74. 

  74.  <div class="refsect1 seealso" id="refsect1-function.inotify-init-seealso">
    75. 

  75.   <h3 class="title">参见</h3>
    76. 

  76.   <p class="para">
    77. 

  77.    <ul class="simplelist">
    78. 

  78.     <li class="member"> <span class="function"><a href="function.inotify-add-watch.html" class="function" rel="rdfs-seeAlso">inotify_add_watch()</a> - Add a watch to an initialized inotify instance</span></li>
    79. 

  79.     <li class="member"> <span class="function"><a href="function.inotify-rm-watch.html" class="function" rel="rdfs-seeAlso">inotify_rm_watch()</a> - Remove an existing watch from an inotify instance</span></li>
    80. 

  80.     <li class="member"> <span class="function"><a href="function.inotify-queue-len.html" class="function" rel="rdfs-seeAlso">inotify_queue_len()</a> - Return a number upper than zero if there are pending events</span></li>
    81. 

  81.     <li class="member"> <span class="function"><a href="function.inotify-read.html" class="function" rel="rdfs-seeAlso">inotify_read()</a> - Read events from an inotify instance</span></li>
    82. 

  82.     <li class="member"> <span class="function"><a href="function.fclose.html" class="function" rel="rdfs-seeAlso">fclose()</a> - 关闭一个已打开的文件指针</span></li>
    83. 

  83.    </ul>
    84. 

  84.   </p>
    85. 

  85.  </div>
    86. 

  86. 

  87. 

  88. </div><hr /><div class="manualnavbar" style="text-align: center;">
    89. 

  89.  <div class="prev" style="text-align: left; float: left;"><a href="function.inotify-add-watch.html">inotify_add_watch</a></div>
    90. 

  90.  <div class="next" style="text-align: right; float: right;"><a href="function.inotify-queue-len.html">inotify_queue_len</a></div>
    91. 

  91.  <div class="up"><a href="ref.inotify.html">Inotify 函数</a></div>
    92. 

  92.  <div class="home"><a href="index.html">PHP Manual</a></div>
    93. 

  93. </div></body></html>
    94. 

  94.