PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_encode_numericentity — Encode les caractères en référence numérique HTML
$string,$map,$encoding = null,$hex = false
Convertit les codes des caractères spécifiés de la string string
en référence numérique HTML.
stringLa string à encoder.
map
map est un tableau qui spécifie les
codes à convertir.
encodingencoding
est l'encodage des caractères. S'il est omis ou null, l'encodage de caractères interne
sera utilisé.
hexSi l'entité de référence retournée devrait être en notation hexadécimale (sinon il est en notation décimale).
La string convertie.
Lève une exception ValueError si
map n'est pas une liste d'ints.
| Version | Description |
|---|---|
| 8.4.0 |
mb_encode_numericentity() lève désormais une
exception ValueError si map
n'est pas une liste d'ints.
|
| 8.0.0 |
encoding est désormais nullable.
|
Exemple #1 Exemple avec 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 );
// Spécifie les valeurs Unicode de début (start_codeN) et fin (end_codeN)
// Ajoutez offsetN à la valeur, et faites un ET bit-à-bit avec maskN, puis
// il convertit la valeur obtenue en entité numérique
?>
Exemple #2 Exemple avec mb_encode_numericentity()
<?php
$str = "aAæÆあア𩸽";
/* Convertit tous les caractères UTF-8 jusqu’à 4 octets en références numériques HTML */
$convmap = [0, 0x1FFFFF, 0, 0x10FFFF];
var_dump(mb_encode_numericentity($str, $convmap, "utf8"));
/* Convertit uniquement les caractères UTF-8 de 2 et 4 octets en références numériques HTML */
$convmap = [
0x80, 0x7FF, 0, 0x10FFFF,
0x10000, 0x1FFFFF, 0, 0x10FFFF,
];
var_dump(mb_encode_numericentity($str, $convmap, "utf8"));
?>L'exemple ci-dessus va afficher :
string(46) "aAæÆあア鸽" string(28) "aAæÆあア鸽"
