prev_message

 $folder->prev_message([msg_num])

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