php man page for imap_mime_header_decode

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)