PHP/ucwords

(PHP 4, PHP 5, PHP 7)

تحوِّل الدالة ucwords()‎ الحرف الأول من كل كلمة من كلمات السلسلة النصيَّة الممرَّرة إليها إلى حرف كبير (uppercase).

الوصف

string ucwords ( string $str [, string $delimiters = " \t\r\n\f\v" ] )

تعيد هذه الدالة السلسلة النصيَّة str بعد أن تحوِّل الحرف الأول من كل كلمة موجودة ضمنها إلى حرف كبير، إن كان هذا الحرف هو حرف أبجدي بالتأكيد.

تُعرَّف "كلمة" في هذه الحالة بأنَّها أي سلسلة نصيَّة تأتي مباشرة بعد أي محرف مدرج ضمن المعامل delimiters؛ المحارف الافتراضيَّة هي المسافة، والانتقال إلى صفحة جديدة (form-feed)، والسطر الجديد، والعودة إلى بداية السطر (carriage return)، ومسافة الجدولة الأفقيَّة (tab)، ومسافة الجدولة العموديَّة (vertical tab).

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

المعاملات

str

السلسلة النصيَّة المراد تبديل حالة الحروف الأولى لكل كلمة من كلماتها.

delimiters

معامل اختياري، ويضم المحارف الفاصلة بين الكلمات.

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

تُعاد السلسلة النصيَّة str بعد تحويل الحروف الأولى لكلماتها إلى حروف كبيرة.

سجل التغييرات

الإصدار	الوصف
5.4.32, 5.5.16	إضافة المعامل delimiters.

أمثلة

المثال 1: استعمال الدالة ucwords()‎

<?php
$foo = 'hello world!';
$foo = ucwords($foo);             // Hello World!

$bar = 'HELLO WORLD!';
$bar = ucwords($bar);             // HELLO WORLD!
$bar = ucwords(strtolower($bar)); // Hello World!
?>

المثال 2: استعمال محارف مخصصة لفصل الكلمات

<?php
$foo = 'hello|world!';
$bar = ucwords($foo);             // Hello|world!

$baz = ucwords($foo, "|");        // Hello|World!
?>

ملاحظات

هذه الدالة آمنة ثنائيًّا (binary safe).

انظر أيضًا

• الدالة ucfirst()‎: تحوِّل الحرف الأول للسلسلة النصيَّة الممرَّرة إليها إلى حرف كبير.
• الدالة strtoupper()‎: تحوِّل جميع أحرف السلسلة النصيَّة المُمرَّرة إليها إلى أحرف كبيرة.
• الدالة strtolower()‎: تحوِّل جميع أحرف السلسلة النصيَّة المُمرَّرة إليها إلى أحرف صغيرة.
• الدالة mb_convert_case()‎: تحوِّل حالة أحرف السلسلة النصيَّة بحسب المعطيات الممرَّرة لها.

مصادر

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