mb_internal_encoding
内部文字エンコーディングを設定あるいは取得する
説明
stringbool mb_internal_encoding(stringnull $encoding
= null
)
パラメータ
-
encoding
-
encoding
は、HTTP 入力文字エンコーディング変換、
HTTP 出力文字エンコーディング変換および
mbstring モジュールの文字列関数においてデフォルトの文字エンコーディングとして使用されます。
マルチバイト正規表現用のエンコーディングは、ここで扱う内部文字エンコーディングとは別であることに注意してください。
戻り値
encoding
が設定された場合、
成功した場合に true
を、失敗した場合に false
を返します。
このとき、マルチバイト正規表現用のエンコーディングは変更されません。
encoding
が省略された場合、
現在の内部文字エンコーディング名を返します。
エラー / 例外
PHP 8.0.0 以降では、
encoding
が不正な値の場合に
ValueError がスローされるようになりました。
これより前のバージョンでは、
E_WARNING
が発生していました。
例
例1 mb_internal_encoding の例
<?php
/* 内部文字エンコーディングをUTF-8に設定 */
mb_internal_encoding("UTF-8");
/* 現在の内部文字エンコーディングを表示 */
echo mb_internal_encoding();
?>
参考
- mb_http_input
- mb_http_output
- mb_detect_order
- mb_regex_encoding