stdio_ext(3)

الاسم
__fbufsize, __flbf, __fpending, __fpurge, __freadable, __freading, __fsetlocking, __fwritable, __fwriting, _flushlbf - واجهات لبنية ملفات الإدخال/الإخراج القياسية

المكتبة
مكتبة سي المعيارية (libc، -lc)

موجز
#include <stdio.h>
#include <stdio_ext.h>

size_t __fbufsize(FILE *stream);
size_t __fpending(FILE *stream);
int __flbf(FILE *stream);
int __freadable(FILE *stream);
int __fwritable(FILE *stream);
int __freading(FILE *stream);
int __fwriting(FILE *stream);
int __fsetlocking(FILE *stream, int type);
void _flushlbf(void);
void __fpurge(FILE *stream);

الوصف
قدّمت Solaris روتينات للسماح بالوصول المنقول إلى داخل بنية FILE، وطبّقت glibc هذه أيضًا.

ترجع الدالة __fbufsize() حجم الخبيئة المستخدمة حاليًا بواسطة الدفق المُعطى.

ترجع الدالة __fpending() عدد المحارف في خبيئة الإخراج. بالنسبة للدفقات واسعة التوجيه، الوحدة هي محارف عريضة. هذه الدالة غير معرّفة على الخبيئات في وضع القراءة، أو المفتوحة للقراءة فقط.

ترجع الدالة __flbf() قيمة غير صفرية إذا كان الدفق مخبّأ سطريًا، وصفرًا بخلاف ذلك.

ترجع الدالة __freadable() قيمة غير صفرية إذا كان الدفق يسمح بالقراءة، وصفرًا بخلاف ذلك.

ترجع الدالة __fwritable() قيمة غير صفرية إذا كان الدفق يسمح بالكتابة، وصفرًا بخلاف ذلك.

ترجع الدالة __freading() قيمة غير صفرية إذا كان الدفق للقراءة فقط، أو إذا كانت آخر عملية على الدفق هي عملية قراءة، وصفرًا بخلاف ذلك.

ترجع الدالة __fwriting() قيمة غير صفرية إذا كان الدفق للكتابة فقط (أو للإلحاق فقط)، أو إذا كانت آخر عملية على الدفق هي عملية كتابة، وصفرًا بخلاف ذلك.

يمكن استخدام الدالة __fsetlocking() لاختيار النوع المطلوب من القفل على الدفق. ترجع النوع الحالي. يمكن أن يأخذ المعامل type القيم الثلاث التالية:

FSETLOCKING_INTERNAL
    تنفيذ قفل ضمني حول كل عملية على الدفق المُعطى (باستثناء عمليات *_unlocked). هذا هو المبدئي.

FSETLOCKING_BYCALLER
    سيتولى المستدعي أمر القفل (ربما باستخدام flockfile(3) في حال وجود أكثر من خيط واحد)، ولن تقوم روتينات stdio بالقفل حتى يُعاد تعيين الحالة إلى FSETLOCKING_INTERNAL.

FSETLOCKING_QUERY
    لا تغيّر نوع القفل. (فقط أرجعه.)

تفرغ الدالة _flushlbf() جميع الدفقات المخبّأة سطريًا. (يفترض ذلك لإجبار الإخراج إلى طرفية، مثلًا قبل قراءة إدخال لوحة المفاتيح.)

تتجاهل الدالة __fpurge() محتويات خبيئة الدفق.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
__fbufsize(), __fpending(), __fpurge(), __fsetlocking() | سلامة الخيوط | MT-Safe race:stream
__flbf(), __freadable(), __freading(), __fwritable(), __fwriting(), _flushlbf() | سلامة الخيوط | MT-Safe

انظر أيضًا
flockfile(3)، fpurge(3)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.