Returns the next pending FAM event.
The function will block until an event is available which can be checked for using fam_pending().
Returns an array that contains a FAM event code in the 'code' element, the path of the file this event applies to in the 'filename' element and optionally a hostname in the 'hostname' element.
The possible event codes are described in detail in the constants part of this section.