iconv_mime_decode

Decodes a `MIME` header field

&reftitle.description; ``string``false```iconv_mime_decode` `string` `string` `int` `mode` 0 ``string``null```encoding`&null;

Decodes a `MIME` header field.

&reftitle.parameters;

`string`

- The encoded header, as a string.

`mode`

- `mode` determines the behaviour in the event `iconv_mime_decode` encounters a malformed `MIME` header field. You can specify any combination of the following bitmasks.

  ## Bitmasks acceptable to `iconv_mime_decode`

  Value | Constant | Description
  1 | ICONV_MIME_DECODE_STRICT | If set, the given header is decoded in full conformance with the standards defined in RFC2047. This option is disabled by default because there are a lot of broken mail user agents that don't follow the specification and don't produce correct `MIME` headers.
  2 | ICONV_MIME_DECODE_CONTINUE_ON_ERROR | If set, `iconv_mime_decode_headers` attempts to ignore any grammatical errors and continue to process a given header.

`encoding`

- The optional `encoding` parameter specifies the character set to represent the result by. If omitted or &null;, iconv.internal_encoding will be used.

&reftitle.returnvalues;

Returns a decoded `MIME` field on success, or &false; if an error occurs during the decoding.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | `encoding` is nullable now.

&reftitle.examples;

### `iconv_mime_decode` example

    <?php
    // This yields "Subject: Prüfung Prüfung"
    echo iconv_mime_decode("Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?=",
                           0, "ISO-8859-1");
    ?>

&reftitle.seealso;

- `iconv_mime_decode_headers`
- `mb_decode_mimeheader`
- `imap_mime_header_decode`
- `imap_base64`
- `imap_qprint`