PHP 8.4.1 Released!

    IntlChar::hasBinaryProperty

    (PHP 7, PHP 8)

    IntlChar::hasBinaryProperty — Check a binary Unicode property for a code point

    Description

    public static IntlChar::hasBinaryProperty(int|string $codepoint, int $property): ?bool

    Checks a binary Unicode property for a code point.

    Unicode, especially in version 3.2, defines many more properties than the original set in UnicodeData.txt.

    The properties APIs are intended to reflect Unicode properties as defined in the Unicode Character Database (UCD) and Unicode Technical Reports (UTR). For details about the properties see » http://www.unicode.org/ucd/. For names of Unicode properties see the UCD file PropertyAliases.txt.

    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{2603}")

    property

    The Unicode property to lookup (see the IntlChar::PROPERTY_* constants).

    Return Values

    Returns true or false according to the binary Unicode property value for codepoint. Also false if property is out of bounds or if the Unicode version does not have data for the property at all, or not for this code point. Returns null on failure.

    Examples

    Example #1 Testing different properties

    <?php
    var_dump    (IntlChar::hasBinaryProperty("A", IntlChar::PROPERTY_ALPHABETIC));
    var_dump(IntlChar::hasBinaryProperty("A", IntlChar::PROPERTY_CASE_SENSITIVE));
    var_dump(IntlChar::hasBinaryProperty("A", IntlChar::PROPERTY_BIDI_MIRRORED));
    var_dump(IntlChar::hasBinaryProperty("[", IntlChar::PROPERTY_ALPHABETIC));
    var_dump(IntlChar::hasBinaryProperty("[", IntlChar::PROPERTY_CASE_SENSITIVE));
    var_dump(IntlChar::hasBinaryProperty("[", IntlChar::PROPERTY_BIDI_MIRRORED));
    ?>

    The above example will output:

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

    See Also

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

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