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

fclose

هشدار

This function starts with a lowercase letter.

توضیحات

یک فایل را می‌بندد. فایل‌ها باید همیشه زمانی که اسکریپت دیگر نیازی به آن‌ها ندارد (بعد از خواندن/نوشتن) بسته شوند.

نامتوضیحات
File:handleهندل فایل برای بستن. توسط fopen برگردانده شده.

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

true - تابع با موفقیت اجرا شد.

false - تابع در اجرا ناموفق بود. فایل نتوانست بسته شود. ممکن است از قبل بسته باشد.

مثال‌ها

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

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

// نوشتن "Hi there!" در فایل
fwrite(handle, "Hi there!");

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

نکات

هشدار

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

توابع مرتبط

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