Edit Report a Bug

    mb_substitute_character

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

    mb_substitute_character — Set/Get substitution character

    Beschreibung

    mb_substitute_character(string|int|null $substitute_character = null): string|int|bool

    Specifies a substitution character when input character encoding is invalid or character code does not exist in output character encoding. Invalid characters may be substituted "none" (no output), string or int value (Unicode character code value).

    This setting affects mb_convert_encoding(), mb_convert_variables(), mb_output_handler(), and mb_send_mail().

    Parameter-Liste

    substitute_character

    Specify the Unicode value as an int, or as one of the following strings:

    • "none": no output
    • "long": Output character code value (Example: U+3000, JIS+7E7E)
    • "entity": Output character entity (Example: Ȁ)

    Rückgabewerte

    If substitute_character is set, it returns true for success, otherwise returns false. If substitute_character is not set, it returns the current setting.

    Changelog

    Version Beschreibung
    8.0.0 Passing an empty string to substitute_character is no longer supported; "none" should be passed instead.
    8.0.0 encoding ist nun nullable (akzeptiert den null-Wert).

    Beispiele

    Beispiel #1 mb_substitute_character() example

    <?php
    /* Set with Unicode U+3013 (GETA MARK) */
    mb_substitute_character(0x3013);

    /* Set hex format */
    mb_substitute_character("long");

    /* Display current setting */
    echo mb_substitute_character();
    ?>

    add a note add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top