mb_substitute_character

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

mb_substitute_character — Définit/Récupère les caractères de substitution

Description

mb_substitute_character ([ mixed $substchar = mb_substitute_character() ] ) : mixed

Spécifie le caractère de substitution des caractères invalides, ou des encodages invalides. Les caractères invalides peuvent être remplacés par NULL (pas d'affichage, ils sont supprimés), une chaîne de caractères ou une valeur entier (valeur d'un code de charactère Unicode).

Ce paramétrage affecte mb_convert_encoding(), mb_convert_variables(), mb_output_handler(), et mb_send_mail().

Liste de paramètres

substchar

Spécifie une valeur Unicode sous la forme d'un entier, ou bien une chaîne de caractères sous ces formes :

  • "none" : pas d'affichage
  • "long" : affiche la valeur hexadécimale (Exemple : U+3000, JIS+7E7E)
  • "entity" : affiche l'entité du caractère (Exemple : Ȁ)

Valeurs de retour

Si substchar est fourni, mb_substitute_character() retourne TRUE en cas de succès, et FALSE en cas d'erreur. Si substchar est omis, mb_substitute_character() retourne une valeur Unicode, ou bien "none"/"long".

Exemples

Exemple #1 Exemple avec mb_substitute_character()

<?php
/* Configure le caractère de substitution avec U+3013 (GETA MARK) */
mb_substitute_character(0x3013);

/* Configure le caractère de substitution avec un format hexadécimal */
mb_substitute_character("long");

/* Affiche la configuration courante */
echo mb_substitute_character();
?>