public function headers($label, $search, array $opts = array())
    {
        $this->_data[Horde_Imap_Client::FETCH_HEADERS][$label] = array_merge(
            $opts,
            array(
                'headers' => array_map('strval', $search)
            )
        );
    }
public function headers($label, $search, array $opts = array())
    {
        $this->_data[Horde_Imap_Client::FETCH_HEADERS][$label] = array_merge(
            $opts,
            array(
                'headers' => array_map('strval', $search)
            )
        );
    }
public function headers ( $ label , $ search , array $ opts = array ( ) ) { $ this -> _data [ Horde_Imap_Client :: FETCH_HEADERS ] [ $ label ] = array_merge ( $ opts , array ( 'headers' => array_map ( 'strval' , $ search ) ) ) ; }
Returns RFC 2822 header text that matches a search string.

This header search work only with the base RFC 2822 message or
message/rfc822 parts.

@param string $label  A unique label associated with this particular
search. This is how the results are stored.
@param array $search  The search string(s) (case-insensitive).
@param array $opts    The following options are available:
- cache: (boolean) If true, and 'peek' is also true, will cache
the result of this call.
DEFAULT: false
- id: (string) The MIME ID to search.
DEFAULT: The base message part
- length: (integer) The length of the substring to return.
DEFAULT: The entire text is returned.
- notsearch: (boolean) Do a 'NOT' search on the headers.
DEFAULT: false
- peek: (boolean) If set, does not set the '\Seen' flag on the
message.
DEFAULT: The seen flag is set.
- start: (integer) If a portion of the full text is desired to be
returned, the starting position is identified here.
DEFAULT: The entire text is returned.
Returns RFC 2822 header text that matches a search string .