fam_next_event() は、次の待機中の FAM イベントを返します。 この関数は、fam_pending() を用いてチェックできる イベントが検出されるまでブロックします。
fam_next_event() は、FAM イベントコードを要素 'code' に、このイベントが適用されるファイルのパスを 要素 'filename' に、 オプションでホスト名を要素 'hostname' に 含む配列を返します。
発生しうるイベントコードの詳細は、このセクションの 定数 の欄にあります。
fam_pending() も参照ください。