# unicode_encode

(No version information available, might be only in CVS)

unicode_encode — Convert a unicode string in any encoding

### Description

string unicode_encode ( unicode `$input` , string `$encoding` [, int `$errmode` ] )

Takes a unicode string and converts it to a string in the specified `encoding` .

### Parameters

`input`

  The unicode string that is converted.

`encoding`

  The new encoding for `input` .

`errmode`

  Conversion error mode. This parameter determines the action to take when the converter cannot convert a character. For a list of available modes, refer to unicode_set_error_mode(). If the parameter is not set, the global error mode is used.

### Return Values

A string on success, or `FALSE` on failure.

### Errors/Exceptions

Emits a `E_WARNING` level error if a converter cannot be created for the desired `encoding` .

### Examples

Example#1 A unicode_encode() example

Note: The characters will be seen instead of entities in the output.

`<?php
header ('Content-Type: text/plain; charset=ISO-8859-2');
$encoded = unicode_encode ('\u0150\u0179', 'ISO-8859-2');
echo 'Unicode semantics: ', ini_get ('unicode_semantics'), PHP_EOL;
echo 'The string itself:', $encoded, PHP_EOL;
echo 'The length of the string: ', strlen ($encoded);
?>`

The above example will output something similar to:

    Unicode semantics: 1
    The string itself: &#336;&#377;
    The length of the string: 2

### Notes

Warning

This function is EXPERIMENTAL. The behaviour of this function, the name of this function, and anything else documented about this function may change without notice in a future release of PHP. Use this function at your own risk.

### See Also

- unicode_set_error_mode()
- unicode_semantics()
- unicode_decode()