ucfirst premier caractère en majuscule

La fonction ucfirst permet de mettre le premier caractère d'une chaîne en majuscules. Cela est fonctionnel uniquement pour les caractères alphabétiques qui sont spécifiés avec la configuration de la localisation. Les caractères spéciaux (comme le é, à, ê ou ö) ne seront pas transformés, ils resteront donc en minuscules au lieu d'apparaître en majuscules, voir le dernier paragraphe intitulé Version multi-octet.

// Retourne $str avec la première lettre en majuscule
string ucfirst ( string $str )

ucfirst retournera la chaîne de caractères str après avoir remplacé la première lettre en majuscule, si celui-ci est un caractère alphabétique, c'est-à-dire qu'il ne comporte pas de caractère comme les accents. Disponible depuis la version PHP 4.

Les paramètres

NomDescriptionObligationType
strLa chaîne d'entrée.Obligatoirestring

Valeur de retour

Retournera la chaîne de caractères après avoir été modifiée.

Exemples d'utilisation

‹?php

$foo = 'bienvenue';
// Retournera "Bienvenue" avec le premier caractère en majuscule
$foo = ucfirst($foo);

$bar = 'BIENVENUE';
// Retournera "BIENVENUE"
$bar = ucfirst($bar);

// Retournera "Bienvenue" avec le premier caractère en majuscule et les autres caractères en minuscule avec la fonction strtolower()
$bar = ucfirst(strtolower($bar));

?›

Version multi-octet

La fonction ucfirst n'est pas une version multi-octet (UTF-8) ce qui ne permet pas de mettre en majuscules les caractères spéciaux. Pour pallier ce problème vous devez créer une fonction multi-octet.

// Retourne la première lettre en majuscules y compris les caractères spéciaux
function mbUcfirst($str, $encode = 'UTF-8') {

	$start = mb_strtoupper(mb_substr($str, 0, 1, $encode), $encode);
	$end = mb_strtolower(mb_substr($str, 1, mb_strlen($str, $encode), $encode), $encode);

	$str = $start.$end;
	return $str;
}

A voir également

  • lcfirst() - Permets de mettre le premier caractère en minuscule.
  • strtolower() - Renvoie la chaîne entièrement en minuscules.
  • strtoupper() - Renvoie la chaîne entièrement en majuscules
  • ucwords() - Permets de mettre les premières lettres de chaque mot en majuscule.

les réactions

Pour laisser un avis, vous devez être inscrit et connecté

Se connecter