fblockwrite

هشدار

This function starts with a lowercase letter.

توضیحات

نوشتن داده در فایل به فرمت باینری، با نادیده گرفتن شکست خط و کدگذاری.

نام	توضیحات
File:handle	هندل فایل برای استفاده، باز شده با ()fopen.
const 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_write);

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

    // نوشتن "some_data" در "file.bin"
    fblockwrite(handle, some_data);

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

نکات

هشدار

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

توابع مرتبط

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