ucfirst

関数の概要

PHPの ucfirst 関数は、文字列の先頭の1文字を大文字に変換し、それ以降の文字は変更しない文字列操作用の関数です。例えば、文章の先頭文字だけを大文字にしたい場合に便利です。

パラメータの説明

  • string $str : 大文字に変換したい元の文字列を指定します。

戻り値

引数で渡された文字列の先頭1文字が大文字になった新しい文字列を返します。引数の文字列が空の場合は、そのまま空文字が返されます。

使用例

基本的な使い方

<?php
echo ucfirst("hello world");
// 出力: Hello world
?>

文字列の先頭「h」が大文字の「H」になり、残りの文字はそのままです。

すでに先頭が大文字の場合

<?php
echo ucfirst("Hello world");
// 出力: Hello world
?>

先頭文字がすでに大文字の場合は変更されず、元のまま返されます。

空文字列を渡した場合

<?php
echo ucfirst("");
// 出力: (空文字がそのまま返される)
?>

空文字列を渡すと何も変わらず空文字列が返されます。

複数単語の文字列でも先頭のみ大文字になる

<?php
echo ucfirst("php is great");
// 出力: Php is great
?>

先頭の単語の最初の1文字だけが大文字になり、それ以降の単語の文字は変更されません。

関連する関数

  • lcfirst : 文字列の先頭の1文字を小文字に変換します。
  • strtoupper : 文字列全体を大文字に変換します。
  • strtolower : 文字列全体を小文字に変換します。
  • ucwords : 文字列内の各単語の先頭文字を大文字に変換します。

まとめ

PHPの ucfirst 関数は、文字列の先頭の1文字だけを大文字に変換するときにシンプルかつ便利な関数です。文章のタイトルや名前の書式を整える際など、実務でよく使われます。複数単語の文字列でも最初の1文字のみが大文字になるため、文字列全体の大文字・小文字を制御したい場合には他の関数と組み合わせて使うと効果的です。