PHPのIntlChar::isMirrored()関数とは？Bidi_Mirroredプロパティの判定方法を解説

PHPのIntlChar::isMirrored()関数は、指定した文字やコードポイントが「Bidi_Mirrored（双方向ミラー）」プロパティを持っているかどうかを判定するための関数です。このプロパティは、右から左へ記述されるアラビア語やヘブライ語などの双方向（BiDi）テキスト処理において、括弧などの文字が文脈に応じて鏡像に反転されるべきかを示すものです。

構文

bool IntlChar::isMirrored(mixed $val)

パラメータ

• val ― 判定対象となる値。UTF-8でエンコードされた1文字、またはUnicodeコードポイントを表す整数値を指定します。

戻り値

指定した値がBidi_Mirroredプロパティを持っている場合は TRUE（true） を返し、持っていない場合は FALSE（false） を返します。

使用例

以下に、IntlChar::isMirrored()関数を使用したサンプルコードを示します。

<?php
    var_dump(IntlChar::isMirrored("<"));
    echo "<br>";
    var_dump(IntlChar::isMirrored(">"));
    echo "<br>";
    var_dump(IntlChar::isMirrored("p"));
    echo "<br>";
    var_dump(IntlChar::isMirrored("*"));
    echo "<br>";
?>

実行結果

上記のコードを実行すると、次のような出力になります。

bool(true)
bool(true)
bool(false)
bool(false)

解説

この例では、「<」と「>」は開き括弧・閉じ括弧として双方向テキストの中で鏡像反転の対象となるため、true が返されます。一方、英字の「p」や記号の「*」は鏡像関係を持たない文字であるため、false が返されます。

注意点

• IntlCharクラスを使用するには、PHPにIntl拡張モジュール（PECL intl）がインストールされている必要があります。

• 引数には整数のコードポイント（例：0x3C）を渡すことも可能です。

• 無効なコードポイントを渡した場合は、警告が発生するか false が返されますので、入力値の検証を行うことをおすすめします。