الدالة floatval()‎ في PHP

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

تُعطي الدالة floatval()‎‎ قيمة من نوع عدد عشري (float) لمتغيّر ما.

الوصف

float floatval ( mixed $var )

تُعطي قيمة من نوع عدد عشري للمتغيّر var.

المعاملات

var

قد يكون من أي نوع عددي. لا يجب استخدام الدالة floatval()‎ مع الكائنات، وينتج عن فعل ذلك خطأ من مستوى E_NOTICE وإعادة القيمة 1.

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

قيمة من نوع عدد عشري للمتغير المُعطى. تُعيد المصفوفات الفارغة القيمة 0، والمصفوفات غير الفارغة القيمة 1.

تُعيد السّلاسل النصّيّة القيمة 0 غالبًا، على الرغم من أنّ هذا يعتمد على المحارف الموجودة في أقصى اليسار من السّلسلة النصّيّة، تنطبق هنا القواعد الشّائعة في تحويل الأعداد العشريّة.

أمثلة

المثال 1: أمثلة على الدالة floatval()‎‎

<?php
$var = '122.34343The';
$float_value_of_var = floatval($var);
echo $float_value_of_var; // 122.34343
?>

المثال 2: مثال على استخدام الدالة floatval()‎ مع أحرف غير عدديّة في أقصى اليسار

<?php
$var = 'The122.34343';
$float_value_of_var = floatval($var);
echo $float_value_of_var; // 0
?>

انظر أيضًا

• الدالة boolval()‎: الحصول على القيمة المنطقيّة (boolean) لمتغيّر ما.
• الدالة intval()‎: الحصول على قيمة من نوع عدد صحيح (integer) لمتغيّر ما.
• الدالة strval()‎: الحصول على قيمة من نوع سلسلة نصّيّة (string) لمتغيّر ما.
• الدالة settype()‎: تعيين نوع متغيّر ما.
• التّعامل مع الأنواع في PHP.

مصادر

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