Reference: select_label

select_label

 $folder->select_label(label)

Returns a list of messages with the label label. If called in scalar context, returns the number of messages that have the label.