mb_encode_numericentity

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

mb_encode_numericentityCodifica los caracteres en referencia numérica HTML

Descripción

mb_encode_numericentity(
    string $string,
    array $map,
    ?string $encoding = null,
    bool $hex = false
): string

Convierte los códigos de los caracteres especificados de la chaîne de caractères string a referencia numérica HTML.

Parámetros

string

La chaîne de caractères a codificar.

map

map es un array que especifica los códigos a convertir.

encoding

El parámetro encoding es la codificación de caracteres. Si es omitido o null, será usado el valor de la codificación de caracteres interna.

hex

Si la entidad de referencia devuelta debe estar en notación hexadecimal (de lo contrario, está en notación decimal).

Valores devueltos

La chaîne de caractères convertida.

Errores/Excepciones

Genera una excepción ValueError si map no es una lista de entiers.

Historial de cambios

Versión Descripción
8.4.0 mb_encode_numericentity() ahora genera una excepción ValueError si map no es una lista de entiers.
8.0.0 encoding ahora es nullable.

Ejemplos

Ejemplo #1 Ejemplo con map

<?php
$convmap = array (
 int start_code1, int end_code1, int offset1, int mask1,
 int start_code2, int end_code2, int offset2, int mask2,
 ........
 int start_codeN, int end_codeN, int offsetN, int maskN );
// Especifica los valores Unicode de inicio (start_codeN) y fin (end_codeN)
// Añade offsetN al valor, y realiza una operación AND a nivel de bits con maskN, luego
// convierte el valor obtenido en entidad numérica
?>

Ejemplo #2 Ejemplo con mb_encode_numericentity()

<?php
$str
= "aAæÆあア𩸽";

/* Convierte todos los caracteres UTF-8 hasta 4 bytes en referencias numéricas HTML */
$convmap = [0, 0x1FFFFF, 0, 0x10FFFF];
var_dump(mb_encode_numericentity($str, $convmap, "utf8"));

/* Convierte únicamente los caracteres UTF-8 de 2 y 4 bytes en referencias numéricas HTML */
$convmap = [
0x80, 0x7FF, 0, 0x10FFFF,
0x10000, 0x1FFFFF, 0, 0x10FFFF,
];
var_dump(mb_encode_numericentity($str, $convmap, "utf8"));
?>

El resultado del ejemplo sería:

string(46) "&#97;&#65;&#230;&#198;&#12354;&#12450;&#40509;"
string(28) "aA&#230;&#198;あア&#40509;"

Ver también