Reference: next_message

next_message

 $folder->next_message([msg_num])

Returns the number of the next message in the folder relative to msg_num if it is specified, otherwise relative to the current message. Returns 0 if at end of folder.