---
title: "fblockread | open.mp"
description: "این تابع به شما امکان خواندن داده از فایل، بدون کدگذاری و پایان‌دهنده‌های خط را می‌دهد."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/fblockread
language: fa
---

# fblockread

## توضیحات

این تابع به شما امکان خواندن داده از فایل، بدون کدگذاری و پایان‌دهنده‌های خط را می‌دهد

| نام | توضیحات |
| --- | --- |
| File:handle | هندل فایل برای استفاده، باز شده با ()fopen |
| buffer | بافر برای ذخیره داده‌های خوانده شده. |
| size = sizeof (buffer) | تعداد سلول‌های برای خواندن. |

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

تعداد سلول‌های خوانده شده. صفر، اگر به انتهای فایل رسیده باشد.

## مثال‌ها

```c
// تعریف "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_read);

// اعلان "file_len"
new file_len;

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

    // دریافت طول فایل "file.bin"
    file_len = flength(handle);

    // اگر فایل به اندازه مساوی با آرایه بزرگ‌تر باشد
    if (file_len == (some_enum * 4))
    {
        // موفقیت

        // خواندن از "file.bin" به درون "some_data"
        fblockread(handle, some_data);
    }
    else
    {
        // خطا
        print("\"file.bin\" is not compatible with the array.");
    }

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

## نکات

هشدار

استفاده از هندل نامعتبر سرور شما را کرش خواهد کرد! یک هندل معتبر با استفاده از [fopen](https://omp.itsneufox.com/fa/docs/scripting/functions/fopen) یا [ftemp](https://omp.itsneufox.com/fa/docs/scripting/functions/ftemp) دریافت کنید.

## توابع مرتبط

-   [fopen](https://omp.itsneufox.com/fa/docs/scripting/functions/fopen): باز کردن یک فایل.
-   [fclose](https://omp.itsneufox.com/fa/docs/scripting/functions/fclose): بستن یک فایل.
-   [ftemp](https://omp.itsneufox.com/fa/docs/scripting/functions/ftemp): ایجاد جریان فایل موقت.
-   [fremove](https://omp.itsneufox.com/fa/docs/scripting/functions/fremove): حذف یک فایل.
-   [fwrite](https://omp.itsneufox.com/fa/docs/scripting/functions/fwrite): نوشتن در فایل.
-   [fread](https://omp.itsneufox.com/fa/docs/scripting/functions/fread): خواندن فایل.
-   [fputchar](https://omp.itsneufox.com/fa/docs/scripting/functions/fputchar): قرار دادن کاراکتر در فایل.
-   [fgetchar](https://omp.itsneufox.com/fa/docs/scripting/functions/fgetchar): دریافت کاراکتر از فایل.
-   [fblockwrite](https://omp.itsneufox.com/fa/docs/scripting/functions/fblockwrite): نوشتن بلوک‌های داده در فایل.
-   [fseek](https://omp.itsneufox.com/fa/docs/scripting/functions/fseek): پرش به کاراکتر مشخص در فایل.
-   [flength](https://omp.itsneufox.com/fa/docs/scripting/functions/flength): دریافت طول فایل.
-   [fexist](https://omp.itsneufox.com/fa/docs/scripting/functions/fexist): بررسی وجود فایل.
-   [fmatch](https://omp.itsneufox.com/fa/docs/scripting/functions/fmatch): بررسی تطبیق الگوها با نام فایل.
-   [ftell](https://omp.itsneufox.com/fa/docs/scripting/functions/ftell): دریافت موقعیت فعلی در فایل.
-   [fflush](https://omp.itsneufox.com/fa/docs/scripting/functions/fflush): فلاش کردن فایل روی دیسک (اطمینان از تکمیل همه نوشتن‌ها).
-   [fstat](https://omp.itsneufox.com/fa/docs/scripting/functions/fstat): برگرداندن اندازه و زمان فایل.
-   [frename](https://omp.itsneufox.com/fa/docs/scripting/functions/frename): تغییر نام فایل.
-   [fcopy](https://omp.itsneufox.com/fa/docs/scripting/functions/fcopy): کپی کردن فایل.
-   [filecrc](https://omp.itsneufox.com/fa/docs/scripting/functions/filecrc): برگرداندن مقدار CRC 32-بیتی فایل.
-   [fattrib](https://omp.itsneufox.com/fa/docs/scripting/functions/fattrib): تنظیم ویژگی‌های فایل.
-   [fcreatedir](https://omp.itsneufox.com/fa/docs/scripting/functions/fcreatedir): ایجاد دایرکتوری.