(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 chaîne de caractères string
en référence numérique HTML.
string
La chaîne de caractères à encoder.
map
map
est un tableau qui spécifie les
codes à convertir.
encoding
Le paramètre encoding
est l'encodage des caractères. S'il est omis ou null
, l'encodage de caractères interne
sera utilisé.
hex
Si l'entité de référence retourné devrait être en notation hexadécimale (sinon il est en notation décimale).
La chaîne de caractères convertie.
Lève une exception ValueError si
map
n'est pas une liste d'entiers.
Version | Description |
---|---|
8.4.0 |
mb_encode_numericentity() lève désormais une
exception ValueError si map
n'est pas une liste d'entiers.
|
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æÆあア鸽"