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.