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 string string a referencia numérica HTML.

Parámetros

string

La string a codificar.

map

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

encoding

The encoding parameter is the character encoding. If it is omitted or null, the internal character encoding value will be used.

hex

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

Valores devueltos

La string convertida.

Errores/Excepciones

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

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 enteros.
8.0.0 encoding is nullable now.

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 ejemplo anterior mostrará :

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

Ver también