عرض مصدر PHP/feof

<noinclude>{{DISPLAYTITLE:الدالة <code>feof()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تتحقَّق الدالة <code>feof()‎</code> من الوصول إلى نهاية ملف (EOF) بتمرير المقبض الذي يشير إلى الملف.

== الوصف ==
<syntaxhighlight lang="php">
bool feof ( resource $handle )
</syntaxhighlight>تتحقَّق هذه الدالة من الوصول إلى نهاية ملف (EOF) بتمرير المقبض <code>handle</code> الذي يشير إلى الملف.

== المعاملات ==

=== handle ===
مقبض (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة <code>[[PHP/fopen|fopen()‎]]</code> أو الدالة <code>[[PHP/fsockopen|fsockopen()‎]]</code>، ولم يُغلق بعد باستعمال الدالة <code>[[PHP/fclose|fclose()‎]]</code>.

== القيم المعادة ==
تُعاد القيمة <code>TRUE</code> إن وصل مقبض الملف إلى نهايته أو إن حصل خطأ (من ضمنها انتهاء مهلة المقبس [socket timeout]). خلا ذلك، ستُعاد القيمة <code>FALSE</code>.

== ملاحظات ==
'''تحذير''': إن لم يُغلق الخادم الاتصال المفتوح باستعمال الدالة <code>[[PHP/fsockopen|fsockopen()‎]]</code>، فستتوقف الدالة <code>feof()‎</code> بصورة طارئة. لتجنب حدوث ذلك، انظر المثال التالي:

المثال 1: معالجة موضوع انتهاء المُهل (timeouts) عند استعمال الدالة <code>feof()‎</code><syntaxhighlight lang="php">
<?php
function safe_feof($fp, &$start = NULL) {
 $start = microtime(true);

 return feof($fp);
}

//fsockopen() مفتوح مسبقًا باستعمال الدالة $fp بفرض أنَّ

$start = NULL;
$timeout = ini_get('default_socket_timeout');

while(!safe_feof($fp, $start) && (microtime(true) - $start) < $timeout)
{
 // هنا يُتعامل مع انتهاء المهلة
}
?>
</syntaxhighlight>'''تحذير''': إن كان مؤشِّر الملف المُمرَّر إلى الدالة <code>feof()‎</code> غير صالح، فربما يؤدي ذلك إلى حلقة تكرار لا نهائيَّة بسبب فشل الدالة في إعادة القيمة <code>TRUE</code>.

المثال 2: استعمال مؤشِّر ملف غير صحيح<syntaxhighlight lang="php">
<?php
// FALSE القيمة fopen() إن كان الملف غير قابل للقراءة أو غير موجود، فستعيد الدالة
$file = @fopen("no_such_file", "r");

// سيُصدر تحذيرًا ويتسبب في جعل حلقة التكرار التالية غير نهائية FALSE القيمة fopen() إعادة الدالة 
while (!feof($file)) {
}

fclose($file);
?>
</syntaxhighlight>

== مصادر ==
* [http://php.net/manual/en/function.feof.php صفحة الدالة feof في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Filesystem]]