fgetchar

هشدار

This function starts with a lowercase letter.

توضیحات

خواندن یک کاراکتر از فایل.

نام	توضیحات
File:handle	دستگیره فایل که بوسیله fopen برگردونده میشه.
value	این پارامتر استفاده ای نداره، فقط "0" رو بذار.
bool:utf8	اگه true باشه، کاراکتر رو به صورت UTF-8 میخونه، در غیر اینصورت extended ASCII. (پیش‌فرض: true)

برگشتی

اگه موفق باشه، مقدار extended ASCII یا UTF-8 کاراکتر در موقعیت فعلی فایل رو برمیگردونه، در غیر اینصورت EOF (آخر فایل).

مثال‌ها

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

// تعریف "g_char"
new g_char;

// چک کردن، اگه "file.txt" باز شده
if (handle)
{
    // خوندن همه کاراکترها، با نادیده گرفتن UTF-8.
    while((g_char = fgetchar(handle, 0, false)) != EOF)
    {
        // چاپ کاراکتر
        printf("[ \"file.txt\" ] 0x%x", g_char);
    }

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

نکات

هشدار

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

توابع مرتبط

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