Define/Recupera los caracteres de sustitución

# mb_substitute_character

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_substitute_character — Define/Recupera los caracteres de sustitución

### Descripción

function mb_substitute_character(string|int|null `$substitute_character` = `null`): string|int|bool

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: `&#x200;`)

### 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 #1 Ejemplo con mb_substitute_character()

    <?php
    /* Configura el carácter de sustitución con U+3013 (GETA MARK) */
    mb_substitute_character(0x3013);

    /* Configura el carácter de sustitución con un formato hexadecimal */
    mb_substitute_character("long");

    /* Muestra la configuración actual */
    echo mb_substitute_character();
    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open