PHPのlcfirst()関数とは？使い方とサンプルコードを解説

PHPのlcfirst()関数は、文字列の先頭1文字だけを小文字に変換するための関数です。変換後の新しい文字列を返し、元の文字列自体は変更されません。

構文

lcfirst(str)

パラメータ

• str − 先頭を小文字に変換したい対象の文字列を指定します。

戻り値

lcfirst()関数は、先頭の1文字が小文字に変換された文字列を返します。それ以外の文字はそのまま維持されます。

使用例

以下は、lcfirst()関数の基本的な使用例です。

<?php
   echo lcfirst("Welcome to the website");
?>

出力結果

上記のコードを実行すると、次のように出力されます。

welcome to the website

別の使用例

続いて、変数に格納した文字列に対してlcfirst()関数を適用する例を見てみましょう。strtoupper()関数と組み合わせることで、挙動の違いも確認できます。

<?php
   $res = 'WEB WORLD!';
   $res = lcfirst($res);
   echo $res;
   $res = lcfirst(strtoupper($res));
   echo $res;
?>

出力結果

上記のコードを実行すると、次のように出力されます。

wEB WORLD!wEB WORLD!

補足：マルチバイト文字の扱いに注意

lcfirst()関数はシングルバイト文字を前提とした関数のため、日本語などのマルチバイト文字には対応していません。マルチバイト文字列を扱う場合は、mb_strtolower()などのマルチバイト対応関数を組み合わせて使用することをおすすめします。

関連する文字列変換関数

• ucfirst() − 文字列の先頭1文字を大文字に変換する

• strtolower() − 文字列全体を小文字に変換する

• strtoupper() − 文字列全体を大文字に変換する

• ucwords() − 各単語の先頭文字を大文字に変換する