mb_ucfirst

(PHP 8 >= 8.4.0)

mb_ucfirst — 文字列の最初の文字を大文字にする

説明

mb_ucfirst(string $string, string $encoding = null): string

マルチバイト対応の ucfirst() 処理を行い、 string の最初の文字をタイトルケースに変換して返します。

パラメータ

string: 入力文字列。
encoding: 文字エンコーディングを指定します。省略した場合、もしくはnullの場合は、内部文字エンコーディングを使用します。

戻り値

変換後の文字列を返します。

注意

注意:
strtolower() や strtoupper()のような関数とは対照的に、ケースフォールディングはUnicode 文字属性を基準に行われます。したがって、この挙動はロケールの設定に影響されず、また、すべてのアルファベット、例えば a ウムラウト (ä)などを変換することができます。

Unicodeプロパティについての詳細はこちらを参照してください» http://www.unicode.org/reports/tr21/。

参考

mb_lcfirst() - 文字列の最初の文字を小文字にする
mb_convert_case() - 文字列に対してケースフォールディングを行う
ucfirst() - 文字列の最初の文字を大文字にする

Found A Problem?

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

＋add a note

User Contributed Notes 1 note

down

hans at loltek dot net ¶

1 month ago

polyfill:

<?php
if(PHP_VERSION_ID < 80400) {
function mb_ucfirst(string $str, string $encoding = null): string
{
    if ($encoding === null) {
        $encoding = mb_internal_encoding();
    }
    return mb_strtoupper(mb_substr($str, 0, 1, $encoding), $encoding) . mb_substr($str, 1, null, $encoding);
}

}
?>

if you wonder why i bother with mb_internal_encoding: prior to php7, $encoding was not nullable. if your polyfill don't need php5.6 support, you can drop it.

＋add a note