الدالة ‎lcfirst في PHP

(PHP 5>=5.3.0, PHP 7)

تُحوِل الدالة ‎lcfirst()‎ الحَرف الأول من السلسلة النصية إلى مُحَرَف صغير (اللغات اللاتينية).

الوصف

string lcfirst ( string $str )

تُعيد الدالة lcfirst()‎ سلسلة نصية مُحَرَفها الاول مُحرَف صغير إذا كان من الحروف الأبجدية.

لاحظ أنَّ الحروف الأبجدية تُحدَّد باستعمال المحليَّة (locale) الحاليَّة. بعبارة أخرى، لن تُحوَّل الحروف الشبيه بالحرف ä في المحليَّة "C" الافتراضيَّة.

يجدر بالذكر أنَّ هذه الدالة لا تجري أيّ تعديلات على النصوص العربية.

المعاملات

str

السلسلة النصية المُدخلة.

القيم المُعادة

تُعيد السلسلة النصية الناتجة عن تصغير أول حرف من حروف السلسلة النصية المُدخلة.

أمثلة

مثال 1: مثال بسيط عن الدالة lcfirst()‎

<?php

$foo = 'HelloWorld';

$foo = lcfirst($foo);             // helloWorld

$bar = 'HELLO WORLD!';

$bar = lcfirst($bar);             // hELLO WORLD!

$bar = lcfirst(strtoupper($bar)); // hELLO WORLD!

?>

انظر ايضًا

• ucfirst()‎: تَحويل ‎الحَرف الأول من السلسلة النصية إلى مُحَرَف كبير.
• strtolower()‎: تَحوِيل ‎محارف السلسلة النصية إلى مُحَارَف صغيرة.
• strtoupper()‎: تَحوِيل ‎محارف السلسلة النصية إلى مُحَارَف كبيرة.
• ucwords()‎: تَحوِيل ‎الحَرف الأول لكلمات السلسلة النصية إلى مُحَرَف كبير.

مصادر

• صفحة الدالة ‎lcfirst في توثيق PHP الرسمي.