الفرق بين المراجعتين لصفحة: «PHP/strval»

من موسوعة حسوب
< PHP
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>strval()</code>‎ في PHP}}</noinclude>'
 
لا ملخص تعديل
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:الدالة <code>strval()</code>‎ في PHP}}</noinclude>
<noinclude>{{DISPLAYTITLE:الدالة <code>strval()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)
تُعطي الدالة <code>strval()‎‎‎‎</code> قيمة من نوع سلسلة نصّيّة لمتغيّر ما.
== الوصف ==
<syntaxhighlight lang="php">
string strval ( mixed $var )
</syntaxhighlight>تُعطي قيمة من نوع سلسلة نصّيّة للمتغيّر <code>var</code>، لمزيد من المعلومات حول التّحويل إلى السّلاسل النصّيّة يُمكِنك الاطلاع على صفحة توثيق [[PHP/string|السلاسل النصّيّة]].
لا تُنسِّق هذه الدالة القيمة المُعادة، إن كنت تبحث عن طريقة لتنسيق قيمة عدديّة كسلسلة نصّيّة فانظر إلى الدالة <code>[[PHP/sprintf|sprintf()]]</code>‎ أو الدالة <code>[[PHP/number format|number_format()]]</code>‎.
== المعاملات ==
=== <code>var</code> ===
القيمة العدديّة التي ستُحوَّل إلى [[PHP/string|سلسلة نصيّة]].
يُمكِن للقيمة <code>var</code> أن تكون من أي نوع أولي أو كائن يعتمد التابع <code>[[PHP/magic#.E2.80.8E toString.28.29.E2.80.8E|toString()‎__]]</code>، لا يُمكِن استخدام الدالة <code>strval()‎</code> مع مصفوفات أو كائنات لا تعتمد التابع <code>[[PHP/magic#.E2.80.8E toString.28.29.E2.80.8E|toString()‎__]]</code>.
== القيم المعادة ==
السّلسلة النصّية للمتغيّر <code>var</code>.
== أمثلة ==
المثال 1: أمثلة على استخدام الدالة <code>strval()</code>‎ مع الدالة السّحريّة <code>[[PHP/magic#.E2.80.8E toString.28.29.E2.80.8E|toString()‎__]]</code> في PHP<syntaxhighlight lang="php">
<?php
class StrValTest
{
    public function __toString()
    {
        return __CLASS__;
    }
}
// Prints 'StrValTest'
echo strval(new StrValTest);
?>
</syntaxhighlight>
== انظر أيضًا ==
* الدالة <code>[[PHP/boolval|boolval()]]</code>‎: الحصول على القيمة المنطقيّة (boolean) لمتغيّر ما.
* الدالة <code>[[PHP/floatval|floatval()]]</code>‎: الحصول على قيمة من نوع عدد عشري (float) لمتغيّر ما.
* الدالة <code>[[PHP/intval|intval()]]</code>‎: الحصول على قيمة من نوع عدد صحيح (integer) لمتغيّر ما.
* الدالة <code>[[PHP/settype|settype()]]</code>‎: تعيين نوع متغيّر ما.
* الدالة <code>[[PHP/sprintf|sprintf()]]</code>‎: إعادة سلسلة نصّيّة مُنسَّقة.
* الدالة <code>[[PHP/number format|number_format()]]</code>‎: تنسيق الأعداد بالآلاف لعرضها.
* الدالة <code>[[PHP/magic#.E2.80.8E toString.28.29.E2.80.8E|toString()‎__]]</code>.
== مصادر ==
* [http://php.net/manual/en/function.strval.php صفحة الدالة strval في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Variable Handling]]

المراجعة الحالية بتاريخ 09:35، 18 أبريل 2018

(PHP 4, PHP 5, PHP 7)

تُعطي الدالة strval()‎‎‎‎ قيمة من نوع سلسلة نصّيّة لمتغيّر ما.

الوصف

string strval ( mixed $var )

تُعطي قيمة من نوع سلسلة نصّيّة للمتغيّر var، لمزيد من المعلومات حول التّحويل إلى السّلاسل النصّيّة يُمكِنك الاطلاع على صفحة توثيق السلاسل النصّيّة.

لا تُنسِّق هذه الدالة القيمة المُعادة، إن كنت تبحث عن طريقة لتنسيق قيمة عدديّة كسلسلة نصّيّة فانظر إلى الدالة sprintf()‎ أو الدالة number_format()‎.

المعاملات

var

القيمة العدديّة التي ستُحوَّل إلى سلسلة نصيّة.

يُمكِن للقيمة var أن تكون من أي نوع أولي أو كائن يعتمد التابع toString()‎__، لا يُمكِن استخدام الدالة strval()‎ مع مصفوفات أو كائنات لا تعتمد التابع toString()‎__.

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

السّلسلة النصّية للمتغيّر var.

أمثلة

المثال 1: أمثلة على استخدام الدالة strval()‎ مع الدالة السّحريّة toString()‎__ في PHP

<?php
class StrValTest
{
    public function __toString()
    {
        return __CLASS__;
    }
}

// Prints 'StrValTest'
echo strval(new StrValTest);
?>

انظر أيضًا

  • الدالة boolval()‎: الحصول على القيمة المنطقيّة (boolean) لمتغيّر ما.
  • الدالة floatval()‎: الحصول على قيمة من نوع عدد عشري (float) لمتغيّر ما.
  • الدالة intval()‎: الحصول على قيمة من نوع عدد صحيح (integer) لمتغيّر ما.
  • الدالة settype()‎: تعيين نوع متغيّر ما.
  • الدالة sprintf()‎: إعادة سلسلة نصّيّة مُنسَّقة.
  • الدالة number_format()‎: تنسيق الأعداد بالآلاف لعرضها.
  • الدالة toString()‎__.

مصادر