Submit a Pull Request Report a Bug

    IntlChar::tolower

    (PHP 7, PHP 8)

    IntlChar::tolower — Преобразование символа Unicode в нижний регистр

    Описание

    public static IntlChar::tolower(int|string $codepoint): int|string|null

    Преобразует символ в его эквивалент в нижнем регистре. Если такового нет, то возвращается исходный символ.

    Список параметров

    codepoint

    Целочисленное (int) задание кода символа (например 0x2603 для U+2603 СНЕГОВИКА), или символ закодированный строку UTF-8 (например "\u{2603}")

    Возвращаемые значения

    Возвращает Simple_Lowercase_Mapping для символа, если существует. Если нет, то возвращает исходный символ. В случае возникновения ошибки возвращает null.

    Возвращаемый тип должен быть int, если только символ не был передан как строка UTF-8 (string), в этом случае вернётся строка (string). В случае возникновения ошибки возвращает null.

    Примеры

    Пример #1 Тестирование различных способов задания

    <?php
    var_dump    (IntlChar::tolower("A"));
    var_dump(IntlChar::tolower("a"));
    var_dump(IntlChar::tolower("Φ"));
    var_dump(IntlChar::tolower("φ"));
    var_dump(IntlChar::tolower("1"));
    var_dump(IntlChar::tolower(ord("A")));
    var_dump(IntlChar::tolower(ord("a")));
    ?>

    Результат выполнения данного примера:

    string(1) "a"
string(1) "a"
string(2) "φ"
string(2) "φ"
string(1) "1"
int(97)
int(97)

    Смотрите также

    • IntlChar::totitle() - Преобразует символ Unicode в titlecase
    • IntlChar::toupper() - Преобразование символа Unicode в верхний регистр
    • mb_strtolower() - Приведение строки к нижнему регистру

    ＋add a note

    User Contributed Notes 1 note

    up
    0
    Patanjali
    3 years ago
    The other function I wrote to replace mb_strtolower may not work properly, as it erroneously equated graphemes with codepoints.

    tolower, like many IntlChar methods, works specifically on codepoints, so requires a codepoint iterator to isolate each.

    Also, because in tolower, if there is no lowercase version of the codepoint, the supplied one is returned, so there is no need to specially test for alphabetic codepoints before conversion.

    <?php
    function u_tolower($text=''){
    // if blank, return blank (don't waste CPU cycles)
    if($text==''){return'';}

    // create the codepoint break iterator to identify the start of each codepoint
    $iterator=IntlBreakIterator::createCodePointInstance();

    // load the text
    $iterator->setText($text);

    // using a parts iterator to extract each codepoint itself, convert and append it to the new string
    $newtext='';
    foreach(    $iterator->getPartsIterator() as $codepoint){$newtext.=IntlChar::tolower($codepoint);}

    // return converted text
    return $newtext;
    }
    ?>
    ＋add a note
    To Top