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

fclose

هشدار

این function با یک حرف کوچک شروع می شود.

توضیحات

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

نامتوضیحات
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: ایجاد دایرکتوری.