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

fwrite

هشدار

This function starts with a lowercase letter.

توضیحات​

متن رو توی فایل بنویس.

نامتوضیحات
File:handleدستگیره فایلی که میخوای توش بنویسی (از fopen برگردونده میشه).
const string[]متنی که میخوای توی فایل بنویسی.

برگشتی​

طول متن نوشته شده به صورت integer.

مثال‌ها​

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

// چک کن که فایل باز شده یا نه
if (handle)
{
    // موفق بود

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

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

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

// شروع کردن "buf"
new buf[128];

// چک کن که فایل باز شده یا نه
if (handle)
{
    // موفق بود

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

    // pointer فایل رو به اولین بایت بذار
    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.");
}

// باز کردن "file.txt" با حالت "فقط اضافه کردن"
new File:handle = fopen("file.txt", io_append);

// چک کن که فایل باز شده یا نه
if (handle)
{
    // موفق بود

    // اضافه کردن "This is a test.\r\n"
    fwrite(handle, "This is a test.\r\n");

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

نکات​

نکته

این تابع توی فایل با UTF-8 مینویسه، که از بعضی کاراکترهای زبان‌های محلی پشتیبانی نمیکنه.

هشدار

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

توابع مرتبط​

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