mb_convert_encoding
En esta página
mb_convert_encoding
Convertir una cadena de un codificación de caracteres a otra
Descripción#
mb_convert_encoding(array $string, string $to_encoding, [array $from_encoding]): array
```php
Convierte la `string` desde `from_encoding`, o la codificación interna actual, a `to_encoding`. Opcionalmente desde `from_encoding`. Si `string` es un `array`, todos sus valores `string` serán convertidos recursivamente.
## Parámetros
`string`
La `string` o `array` a convertir.
`to_encoding`
La codificación deseada del resultado.
`from_encoding`
La codificación actual utilizada para interpretar la `string`. Múltiples codificaciones pueden ser especificadas en forma de array (`array`) o lista separada por comas. En este caso, la codificación correcta será adivinada utilizando el mismo algoritmo que `mb_detect_encoding`.
Si `from_encoding` es omitido o `null`, el parámetro [mbstring.internal_encoding](#ini.mbstring.internal-encoding) será utilizado si está definido, de lo contrario el parámetro [default_charset](#ini.default-charset) será utilizado.
Ver [codificaciones soportadas](#mbstring.supported-encodings) para los valores válidos de `to_encoding` y `from_encoding`.
## Valores devueltos
La `string` o `array` codificado en caso de éxito, o `false` si ocurre un error.
## Errores/Excepciones
A partir de PHP 8.0.0, una `ValueError` es lanzada si la valor de `to_encoding` o `from_encoding` es una codificación inválida. Anterior a PHP 8.0.0, una `E_WARNING` era emitida en su lugar.
## Historial de cambios
| Versión | Descripción |
|----|----|
| 8.2.0 | `mb_convert_encoding` ya no devolverá las siguientes codificaciones no textuales: `"Base64"`, `"QPrint"`, `"UUencode"`, `"HTML entities"`, `"7 bit"` y `"8 bit"`. |
| 8.0.0 | `mb_convert_encoding` lanzará ahora una `ValueError` cuando `to_encoding` es pasado una codificación inválida. |
| 8.0.0 | `mb_convert_encoding` lanzará ahora una `ValueError` cuando `from_encoding` es pasado una codificación inválida. |
| 8.0.0 | `from_encoding` ahora es nullable. |
| 7.2.0 | Esta función ahora acepta un `array` como `string`. Anteriormente, solo las `string` eran soportadas. |
## Ejemplos
Ejemplo con `mb_convert_encoding`
```php
Véase también#
mb_detect_order, UConverter::transcode, iconv