PHP/fgetc

(PHP 4, PHP 5, PHP 7)

تَجلُب الدالة fgetc()‎ محرفًا من ملف محدَّد ثمَّ تعيده.

الوصف

string fgetc ( resource $handle )

تجلب هذه الدالة محرفًا واحدًا من الملف الذي يشير إليه المورد handle.

المعاملات

handle

مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎، ولم يُغلق بعد باستعمال الدالة fclose()‎.

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

تُعاد سلسلة نصيَّة تحتوي على حرف واحد قُرِءَ من الملف الذي يشير إليه المورد handle، أو تُعاد القيمة FALSE عند الوصول إلى نهاية الملف (EOF).

تحذير: قد تعيد أحيانًا هذه الدالة القيمة المنطقيَّة FALSE، وقد تعيد أحيانًا أخرى قيمة غير منطقيَّة ولكنَّها تعادل القيمة FALSE، لذا استعمل المعامل === للتحقُّق من القيمة التي تعيدها هذه الدالة. راجع قسم القيم المنطقيَّة (booleans) للمزيد من التفاصيل.

أمثلة

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

<?php
$fp = fopen('somefile.txt', 'r');
if (!$fp) {
    echo 'Could not open file somefile.txt';
}
while (false !== ($char = fgetc($fp))) {
    echo "$char\n";
}
?>

ملاحظات

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

انظر أيضًا

• الدالة fread()‎: تقرأ بطريقة آمنة ثنائيًّا من ملف.
• الدالة fopen()‎: تفتح ملفًا أو عنوان URL.
• الدالة popen()‎: تفتح عمليَّة وتشير إليها بمؤشر شبيه بمؤشر ملف.
• الدالة fsockopen()‎: تفتح اتصالًا بالإنترنت أو بمقبس نطاق يونكس (Unix domain socket).
• الدالة fgets()‎: تجلب سطرًا من ملف محدَّد.

مصادر

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