تابع fgets() پایتون

تعریف و استفاده

تابع fgets() از یک اشاره‌گر فایل یک خط را می‌خواند.

جملات دستوری

fgets(file,length)
پارامترها توضیحات
file ضروری. تعیین فایل مورد نیاز برای خواندن.
length اختیاری. تعیین تعداد بایت‌هایی که باید خوانده شوند. پیش‌فرض 1024 بایت است.

توضیحات

از file یک سطر از فایل به مدت حداکثر length - یک رشته 1 بایتی. به خط پایان سطر (که در برمی‌گردد)، EOF یا زمانی که داده‌ها خوانده شده‌اند، length - در 1 بایت بعد متوقف شود (بستگی به این دارد که کدام یک از این دو اولین بار برخورد شود). اگر مشخص نشده باشد length، به طور پیش‌فرض 1K یا 1024 بایت است.

در صورت شکست، false برمی‌گرداند.

راهنمایی‌ها و یادداشت‌ها

نکته:length این پارامتر از PHP 4.2.0 به بعد به عنوان گزینه‌ای است، اگر نادیده گرفته شود، طول سطر به طور پیش‌فرض 1024 بایت در نظر گرفته می‌شود. از PHP 4.3 به بعد، نادیده گرفتن length به صورت مداوم از جریان داده‌ها تا پایان سطر خوانده خواهد شد. اگر اغلب سطرهای فایل بزرگتر از 8 KB باشند، تعیین طول سطرهای بیشینه در اسکریپت در استفاده از منابع مؤثرتر خواهد بود.

نکته:از PHP 4.3 به بعد این فونکشن می‌تواند به طور امن برای فایل‌های باینری استفاده شود. نسخه‌های قبلی این امکان را ندارند.

نکته:اگر در حال خواندن فایل توسط PHP خط پایان سطر فایل Macintosh شناسایی نشود، می‌توانید گزینه تنظیمات اجرایی auto_detect_line_endings را فعال کنید.

مثال

مثال 1

<?php
$file = fopen("test.txt","r");
echo fgets($file);
fclose($file);
?>

خروجی مشابه:

سلام، این یک فایل آزمایشی است.

مثال 2

<?php
$file = fopen("test.txt","r");
while(! feof($file))
  {
  echo fgets($file) . "<br />";
  }
fclose($file);
?>

خروجی مشابه:

سلام، این یک فایل آزمایشی است. 
اینجا سه خط است. 
این آخرین خط است.