IntlChar::charMirror
(PHP 7, PHP 8)
IntlChar::charMirror — Get the "mirror-image" character for a code point
Description
$codepoint
): int|string|nullMaps the specified character to a "mirror-image" character.
For characters with the Bidi_Mirrored property, implementations sometimes need a "poor man's" mapping to another Unicode character (code point) such that the default glyph may serve as the mirror-image of the default glyph of the specified character. This is useful for text conversion to and from codepages with visual order, and for displays without glyph selection capabilities.
Parameters
-
codepoint
-
The int codepoint value (e.g.
0x2603
for U+2603 SNOWMAN), or the character encoded as a UTF-8 string (e.g."\u"
)
Return Values
Returns another Unicode code point that may serve as a mirror-image substitute, or codepoint
itself if there is no such mapping or codepoint
does not have the
Bidi_Mirrored property.
The return type is int unless the code point was passed as a UTF-8 string, in which case a string is returned. Returns null
on failure.
Examples
Example #1 Testing different code points
<?php
var_dump(IntlChar::charMirror("A"));
var_dump(IntlChar::charMirror("<"));
var_dump(IntlChar::charMirror("("));
?>
The above example will output:
string(1) "A" string(1) ">" string(2) ")"
See Also
- IntlChar::isMirrored() - Check if code point has the Bidi_Mirrored property
IntlChar::PROPERTY_BIDI_MIRRORED