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.