select

 $

folder


->select
(\$

func_ref

)

Returns a list of messages that meet a set of criteria. The argument, \$func_ref , is a reference to a function used to determine the criteria. The function is passed a reference to a Mail::Internet object containing only a header. The list is returned in no specific order.