array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.mb-encode-numericentity.php', 1 => 'mb_encode_numericentity', 2 => 'Encode les caractères en référence numérique HTML', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Fonctions sur les chaînes de caractères multioctets', ), 'prev' => array ( 0 => 'function.mb-encode-mimeheader.php', 1 => 'mb_encode_mimeheader', ), 'next' => array ( 0 => 'function.mb-encoding-aliases.php', 1 => 'mb_encoding_aliases', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/mbstring/functions/mb-encode-numericentity.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mb_encode_numericentity

(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

Description

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

Convertit les codes des caractères spécifiés de la chaîne de caractères string en référence numérique HTML.

Liste de paramètres

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ée devrait être en notation hexadécimale (sinon il est en notation décimale).

Valeurs de retour

La chaîne de caractères convertie.

Erreurs / Exceptions

Lève une exception ValueError si map n'est pas une liste d'entiers.

Historique

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.

Exemples

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) "&#97;&#65;&#230;&#198;&#12354;&#12450;&#40509;"
string(28) "aA&#230;&#198;あア&#40509;"

Voir aussi