Documentación offline PHP master

mb_substitute_character

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

mb_substitute_character

Define/Recupera los caracteres de sustitución

Descripción#

mb_substitute_character([string $substitute_character]): string
```php

Especifica el carácter de sustitución para caracteres inválidos o codificaciones inválidas. Los caracteres inválidos pueden ser reemplazados por `"none"` (no se muestra, se eliminan), una `string` o un valor `int` (valor de un código de carácter Unicode).

Esta configuración afecta a `mb_convert_encoding`, `mb_convert_variables`, `mb_output_handler`, `mb_scrub`, y `mb_send_mail`.

## Parámetros

`substitute_character`  
Especifica un valor Unicode en forma de `int`, o bien una `string` en las siguientes formas:

- `"none"` : no se muestra

- `"long"` : muestra el valor hexadecimal (Ejemplo: `U+3000`, `JIS+7E7E`)

- `"entity"` : muestra la entidad del carácter (Ejemplo: `Ȁ`)

## Valores devueltos

Si `substitute_character` es proporcionado, `mb_substitute_character` devuelve `true` en caso de éxito, y `false` en caso de error. Si `substitute_character` es omitido, `mb_substitute_character` devuelve un valor Unicode, o bien "`none`"/"`long`".

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | Pasar una cadena vacía a `substitute_character` ya no es soportado; `"none"` debería ser proporcionado en su lugar. |
| 8.0.0 | `encoding` ahora acepta `null`. |

## Ejemplos

Ejemplo con `mb_substitute_character`

```php