الاسم¶

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

المكتبة¶

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

موجز¶

#include <stdio.h>

FILE *stdin;
FILE *stdout;
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.