fblockread

هشدار

This function starts with a lowercase letter.

توضیحات

این تابع به شما امکان خواندن داده از فایل، بدون کدگذاری و پایان‌دهنده‌های خط را می‌دهد

نام	توضیحات
File:handle	هندل فایل برای استفاده، باز شده با ()fopen
buffer	بافر برای ذخیره داده‌های خوانده شده.
size = sizeof (buffer)	تعداد سلول‌های برای خواندن.

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

تعداد سلول‌های خوانده شده. صفر، اگر به انتهای فایل رسیده باشد.

مثال‌ها

// تعریف "some_enum"
enum _:some_enum
{
    some_data1,
    some_data2[20],
    Float:some_data3
}

// اعلان "some_data"
new some_data[some_enum];

// ...

// باز کردن "file.bin" در حالت "فقط خواندنی"
new File:handle = fopen("file.bin", io_read);

// اعلان "file_len"
new file_len;

// بررسی اینکه آیا "file.bin" باز است
if (handle)
{
    // موفقیت

    // دریافت طول فایل "file.bin"
    file_len = flength(handle);

    // اگر فایل به اندازه مساوی با آرایه بزرگ‌تر باشد
    if (file_len == (some_enum*4))
    {
        // موفقیت

        // خواندن از "file.bin" به درون "some_data"
        fblockread(handle, some_data);
    }
    else
    {
        // خطا
        print("\"file.bin\" is not compatible with the array.");
    }

    // بستن "file.bin"
    fclose(handle);
}
else
{
    // خطا
    print("Failed to open \"file.bin\".");
}

نکات

هشدار

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

توابع مرتبط

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