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