lcfirst

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

lcfirstWandelt den ersten Buchstaben eines Strings in einen Kleinbuchstaben um

Beschreibung

lcfirst ( string $string ) : string

Gibt einen verarbeitete Version von string zurück, in der das erste Zeichen in einen Kleinbuchstaben umgewandelt wurde, sofern es sich um einen Buchstaben handelte.

Beachten Sie, dass die möglichen "Buchstaben" von der aktuellen locale-Einstellung bestimmt werden. Ist diese zum Beispiel "C", werden Zeichen wie ein Ä nicht konvertiert.

Parameter-Liste

string

Der Eingabestring.

Rückgabewerte

Gibt die verarbeitete Zeichenkette zurück.

Beispiele

Beispiel #1 lcfirst()-Beispiel

<?php
$foo 
'HalloWelt';
$foo lcfirst($foo);             // halloWelt

$bar 'HALLO WELT!';
$bar lcfirst($bar);             // hALLO WELT!
$bar lcfirst(strtoupper($bar)); // hALLO WELT!
?>

Siehe auch

  • ucfirst() - Verwandelt das erste Zeichen eines Strings in einen Großbuchstaben
  • strtolower() - Setzt einen String in Kleinbuchstaben um
  • strtoupper() - Wandelt alle Zeichen eines Strings in Großbuchstaben um
  • ucwords() - Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings in einen Großbuchstaben um

add a note add a note

User Contributed Notes 4 notes

up
18
phpnet at katylavallee dot com
15 years ago
Easiest work-around I've found for <5.3:
<?php

$string
= "CamelCase"
$string{0} = strtolower($string{0})
echo
$string; // outputs camelCase

?>
up
5
alex aulbach
15 years ago
In some cases maybe more useful?

$lower = strtolower( substr($upper,0,1) ) . substr($upper,1);
up
3
harmor
16 years ago
A slight modification from Northie's post here ( http://us2.php.net/manual/en/function.ucfirst.php#68443), where lcfirst may not exist in your PHP build:

<?php

if(false === function_exists('lcfirst'))
{
   
/**
     * Make a string's first character lowercase
     *
     * @param string $str
     * @return string the resulting string.
     */
   
function lcfirst( $str ) {
       
$str[0] = strtolower($str[0]);
        return (string)
$str;
    }
}

/* Tests */
echo var_dump(lcFirst(NULL)).'<br />';    /* string(0) ""  */
echo var_dump(lcFirst(''))  .'<br />';    /* string(0) ""  */
echo var_dump(lcFirst('S')) .'<br />';    /* string(1) "S" */
echo var_dump(lcFirst('É')) .'<br />';    /* string(0) "�" */
echo var_dump(lcFirst('Hello World!!!')); /* string(14) "hello World!!!"  */
up
-24
ahlers_wim at hotmail dot com
15 years ago
As of PHP release 6 direct reference modification is not permitted any more.
Reference modification is the process of manipulating characters within a string by means of the instruction such as:
$str[0] in the code line: $str[0] = strtolower($str[0]);

For this reason I have recoded the lcfirst function (on function_exists('lcfirst') === false) as follows:

<?php
if ( false === function_exists('lcfirst') ):
    function
lcfirst( $str )
    { return (string)(
strtolower(substr($str,0,1)).substr($str,1));}
endif;
?>

Remarks:
Also notice that I have used the more modern scope delimeters (if:-endif;) and I have also removed the unnecessary intermediate result. That is, the manipulation is returned directly.
To Top