Set/Get substitution character

mb_strwidth
mb_substr_count
Multibyte String Functions
PHP Manual

# mb_substitute_character

(PHP 4 >= 4.0.6, PHP 5)

mb_substitute_character — Set/Get substitution character

### Description

mixed mb_substitute_character ([ mixed `$substrchar` ] )

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 `NULL` (no output), string or integer value (Unicode character code value).

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

### Parameters

`substrchar`

  Specify the Unicode value as an integer , or as one of the following string s:

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

### Return Values

If `substchar` is set, it returns `TRUE` for success, otherwise returns `FALSE`. If `substchar` is not set, it returns the Unicode value, or "none" or "long".

### Examples

Example #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();
?>`

mb_strwidth
mb_substr_count
Multibyte String Functions
PHP Manual