الدالة ftell() في PHP
(PHP 4, PHP 5, PHP 7)
تعيد الدالة ftell() الموقع الحالي لمؤشِّر القراءة من أو الكتابة على الملف.
الوصف
int ftell ( resource $handle )
تعيد هذه الدالة الموقع الحالي لمؤشِّر الملف المُشار إليه باستعمال المورد handle.
المعاملات
handle
مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen() أو الدالة popen(). ستعيد الدالة نتائج غير متوقَّعة عند فتح الملف باستعمال الوضع 'a' (إضافة البيانات إلى الملف فقط).
القيم المعادة
يُعاد عدد صحيح يُمثِّل موقع المؤشِّر للملف الذي يشير إليه المورد handle. أي قيمة إزاحة المؤشِّر ضمن مجرى الملف. تُعاد القيمة FALSE عند حدوث أي خطأ.
ملاحظة: لمَّا كان نوع الأعداد الصحيحة في PHP هو ذات إشارة (signed) وأغلب المنصات تستعمل الأعداد الصحيحة بطول 32 بت، فقد تعيد بعض دوال نظام الملفات نتائج مخالفة للتوقعات عند استعمالها مع ملفات ذات حجم أكبر من 2 غيغابايت.
أمثلة
المثال 1: استعمال الدالة ftell()
<?php
// فتح الملف وقراءة بعض البيانات
$fp = fopen("/etc/passwd", "r");
$data = fgets($fp, 12);
// أين نحن الآن؟
echo ftell($fp); // 11
fclose($fp);
?>
انظر أيضًا
- الدالة
rewind(): تُرجع المؤشِّر إلى موقع بداية الملف. - الدالة
fseek(): تحرِّك مؤشِّر الملف الحالي إلى موقع محدَّد. - الدالة
fopen(): تفتح ملفًا أو عنوان URL. - الدالة
popen(): تفتح عمليَّة وتشير إليها بمؤشر شبيه بمؤشر ملف.