fam_next_event() retorna o próximo evento FAM pendente. A função irá bloquear até que um evento que está disponível possa ser checado usando fam_pending().
fam_next_event() irá retornar um array que contém um código de evento FAM no elemento 'code', o path do arquivo desse evento aplicado para o elemento 'filename' e opcionalmente um hostname no elemento 'hostname'.
Os possíveis códigos do evento são descritos em detalhes na parte de constantes dessa seção.
See also fam_pending().