IMAP_MIME_HEADER_DECODE(3)						 1						IMAP_MIME_HEADER_DECODE(3)

imap_mime_header_decode - Decode MIME header elements

SYNOPSIS

       array imap_mime_header_decode (string  $text)

DESCRIPTION

	Decodes MIME message header extensions that are non ASCII text (see RFC2047).

PARAMETERS

	      o $text
		- The MIME text

RETURN VALUES

	The decoded elements are returned in an array of objects, where each object has two properties, charset and text.

	If the element hasn't been encoded, and in other words is in plain US-ASCII, the charset property of that element is set to default.

EXAMPLES

       Example #1

	      imap_mime_header_decode(3) example

	      <?php
	      $text = "=?ISO-8859-1?Q?Keld_J=F8rn_Simonsen?= <keld@example.com>";

	      $elements = imap_mime_header_decode($text);
	      for ($i=0; $i<count($elements); $i++) {
		  echo "Charset: {$elements[$i]->charset}
";
		  echo "Text: {$elements[$i]->text}

";
	      }
	      ?>

	      The above example will output:

	      Charset: ISO-8859-1
	      Text: Keld Jorn Simonsen

	      Charset: default
	      Text:  <keld@example.com>

	In  the  above	example  we would have two elements, whereas the first element had previously been encoded with ISO-8859-1, and the second
       element would be plain US-ASCII.

SEE ALSO

       imap_utf8(3).

PHP Documentation Group 												IMAP_MIME_HEADER_DECODE(3)