الاسم¶

stdio - دوال مكتبة الإدخال/الإخراج القياسية

المكتبة¶

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

موجز¶

#include <stdio.h>

extern FILE  *stdin;
extern FILE  *stdout;
extern FILE  *stderr;

الوصف¶

توفر مكتبة الإدخال/الإخراج القياسية واجهة إدخال/إخراج مخزنة بسيطة وفعالة للدفق. يُخطط الإدخال والإخراج في تدفقات بيانات منطقية وتُخفى خصائص الإدخال/الإخراج الفيزيائية. الدوال والوحدات الكلية مذكورة أدناه؛ تتوفر معلومات إضافية من صفحات الدليل الفردية.

يُربط الدفق بملف خارجي (قد يكون جهازًا فيزيائيًا) عبر فتح ملف، قد يتضمن إنشاء ملف جديد. إنشاء ملف موجود يؤدي إلى تجاهل محتوياته السابقة. إذا كان الملف يدعم طلبات التموضع (مثل ملف قرص، على عكس الطرفية)، فسيُوضع مؤشر موضع الملف المرتبط بالدفق في بداية الملف (البايت صفر)، ما لم يُفتح الملف بوضع الإلحاق. إذا استُخدم وضع الإلحاق، فغير محدد ما إذا كان مؤشر الموضع سيُوضع في بداية الملف أو نهايته. يُحافظ على مؤشر الموضع بواسطة عمليات القراءة والكتابة وطلبات التموضع اللاحقة. يحدث كل الإدخال كما لو أن المحارف قُرئت باستدعاءات متتالية لدالة fgetc(3)؛ يحدث كل الإخراج كما لو أن جميع المحارف كُتبت باستدعاءات متتالية لدالة fputc(3).

يُفصل الملف عن الدفق عبر إغلاق الملف. تُفرغ تدفقات الإخراج (تُنقل أي محتويات خبيئة غير مكتوبة إلى البيئة المضيفة) قبل فصل الدفق عن الملف. قيمة مؤشر لكائن FILE تكون غير محددة بعد إغلاق الملف (مهملة).

قد يُعاد فتح ملف لاحقًا، بتنفيذ نفس البرنامج أو برنامج آخر، وتُستعاد محتوياته أو تُعدل (إذا أمكن إعادة تموضعه في البداية). إذا عادت الدالة الرئيسية إلى المستدعي الأصلي، أو استُدعيت دالة exit(3)، فتُغلق جميع الملفات المفتوحة (وبالتالي تُفرغ جميع تدفقات الإخراج) قبل إنهاء البرنامج. طرق أخرى لإنهاء البرنامج، مثل abort(3)، لا تهتم بإغلاق الملفات بشكل صحيح.

عند بدء البرنامج، تُعرّف ثلاثة تدفقات نصية مسبقًا ولا تحتاج إلى فتح صريح: الإدخال القياسي (لقراءة الإدخال التقليدي)، الإخراج القياسي (لكتابة الإخراج التقليدي)، والخطأ القياسي (لكتابة الإخراج التشخيصي). تُختصر هذه التدفقات إلى stdin وstdout وstderr. عند فتحها، لا يكون دفق الخطأ القياسي مخزنًا بالكامل؛ تكون تدفقات الإدخال والإخراج القياسية مخزنة بالكامل إذا وفقط إذا لم تشير التدفقات إلى جهاز تفاعلي.

تدفقات الإخراج التي تشير إلى أجهزة طرفية تكون دائمًا مخزنة سطريًا مبدئيًا؛ يُكتب الإخراج المعلق لمثل هذه التدفقات آليًا كلما قُرئ دفق إدخال يشير إلى جهاز طرفي. في الحالات التي يُجرى فيها قدر كبير من الحساب بعد طباعة جزء من سطر على طرفية إخراج، من الضروري تفريغ fflush(3) الإخراج القياسي قبل الانطلاق والحساب حتى يظهر الإخراج.

مكتبة stdio هي جزء من المكتبة libc وتُحمل الإجراءات آليًا حسب الحاجة بواسطة cc(1). تشير أقسام الملخص في صفحات الدليل التالية إلى ملفات التضمين التي ستُستخدم، وكيف يبدو إعلان المترجم للدالة، والمتغيرات الخارجية ذات الاهتمام.

التالية مُعرّفة كوحدات كلية؛ لا يُعاد استخدام هذه الأسماء دون إزالة تعريفاتها الحالية أولاً باستخدام #undef: BUFSIZ، EOF، FILENAME_MAX، FOPEN_MAX، L_cuserid، L_ctermid، L_tmpnam، NULL، SEEK_END، SEEK_SET، SEEK_CUR، TMP_MAX، clearerr، feof، ferror، fileno، getc، getchar، putc، putchar، stderr، stdin، stdout. توجد إصدارات دوال للوحدات الكلية feof وferror وclearerr وfileno وgetc وgetchar وputc وputchar وتُستخدم إذا أُزيلت تعريفات الوحدات الكلية صراحةً.

المعايير¶

C11, POSIX.1-2008.

التاريخ¶

C89, POSIX.1-2001.

انظر أيضًا¶

close(2), open(2), read(2), write(2), stdout(3), unlocked_stdio(3)

ترجمة¶

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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