پرش به مطلب اصلی

fread

هشدار

This function starts with a lowercase letter.

توضیحات​

یک خط از یک فایل رو می‌خونه.

نامتوضیحات
File:handleهندل فایل که ازش خونده می‌شه (توسط fopen برگردونده شده).
string[]آرایه string برای ذخیره متن خونده شده، که با reference پاس می‌شه.
size = sizeof (string)تعداد بایت‌هایی که باید خونده بشن.
bool:packآیا string باید pack شده باشه؟ (پیش‌فرض: false).

مقدار بازگشتی​

طول string (متن خونده شده) به عنوان یک integer.

مثال‌ها​

// باز کردن "file.txt" در حالت "read only"
new File:handle = fopen("file.txt", io_read);

// مقداردهی "buf"
new buf[128];

// بررسی، اگه فایل باز شده باشه
if (handle)
{
    // موفق

    // خواندن کل فایل
    while(fread(handle, buf))
    {
        print(buf);
    }

    // بستن فایل
    fclose(handle);
}
else
{
    // خطا
    print("The file \"file.txt\" does not exists, or can't be opened.");
}

// باز کردن "file.txt" در حالت "read and write"
new File:handle = fopen("file.txt");

// مقداردهی "buf"
new buf[128];

// بررسی، اگه فایل باز باشه
if (handle)
{
    // موفق

    // خواندن کل فایل
    while(fread(handle, buf))
    {
        print(buf);
    }

    // تنظیم اشاره‌گر فایل به اولین بایت
    fseek(handle, _, seek_begin);

    // نوشتن "I just wrote here!" در این فایل
    fwrite(handle, "I just wrote here!");

    // بستن فایل
    fclose(handle);
}
else
{
    // خطا
    print("The file \"file.txt\" does not exists, or can't be opened.");
}

نکات​

هشدار

استفاده از هندل نامعتبر سرور شما رو کرش می‌کنه! یه هندل معتبر با استفاده از fopen یا ftemp بگیرین.

توابع مرتبط​

  • fopen: باز کردن یک فایل.
  • fclose: بستن یک فایل.
  • ftemp: ایجاد یک جریان فایل موقت.
  • fremove: حذف یک فایل.
  • fwrite: نوشتن در یک فایل.
  • fputchar: قرار دادن یک کاراکتر در فایل.
  • fgetchar: گرفتن یک کاراکتر از فایل.
  • fblockwrite: نوشتن بلوک‌های داده در فایل.
  • fblockread: خواندن بلوک‌های داده از فایل.
  • fseek: پرش به یک کاراکتر خاص در فایل.
  • flength: گرفتن طول فایل.
  • fexist: بررسی، اگه فایل وجود داشته باشه.
  • fmatch: بررسی، اگه الگوها با نام فایل مطابقت داشته باشن.
  • ftell: گرفتن موقعیت فعلی در فایل.
  • fflush: فلاش کردن فایل روی دیسک (اطمینان از تکمیل تمام نوشته‌ها).
  • fstat: برگرداندن اندازه و زمان فایل.
  • frename: تغییر نام فایل.
  • fcopy: کپی فایل.
  • filecrc: برگرداندن مقدار CRC 32-bit فایل.
  • diskfree: برگرداندن فضای خالی دیسک.
  • fattrib: تنظیم خصوصیات فایل.
  • fcreatedir: ایجاد یک دایرکتوری.