دالة fprintf في لغة C: الشرح الكامل مع الأمثلة والتطبيقات

1. ما هي دالة fprintf

نظرة عامة أساسية على fprintf

fprintf هي إحدى دوال الإدخال/الإخراج القياسية في لغة C. وظيفتها الرئيسية هي “إخراج النصوص بتنسيق محدد”. باستخدام fprintf يمكن كتابة البيانات إلى وجهة الإخراج مع تنسيقها وفقًا للنمط المطلوب.

عادةً ما تُستخدم fprintf في المواقف التالية:

• • إنشاء ملفات السجل (Logs): لتسجيل تاريخ التنفيذ أو رسائل الخطأ.
  • حفظ البيانات بتنسيق محدد: تخزين الأعداد أو النصوص في ملف بشكل منظم.

• إخراج معلومات التصحيح (Debug): لطباعة بيانات تساعد في التحقق من عمل البرنامج أثناء التطوير.

البنية الأساسية لدالة fprintf

int fprintf(FILE *stream, const char *format, ...);

شرح أجزاء البنية

• FILE *stream: يحدد مكان الكتابة. مثل الإخراج القياسي (stdout) أو ملف مفتوح بواسطة fopen.
• const char *format: سلسلة نصية تحدد تنسيق الإخراج، وتكتب بنفس أسلوب دالة printf.
• ...: الوسائط المتغيرة (arguments) التي تحتوي على البيانات المراد طباعتها.

ترجع الدالة عدد الأحرف المكتوبة (عدد صحيح موجب). في حالة حدوث خطأ، تُرجع -1.

مقارنة مع دوال أخرى

من الدوال المشابهة لـ fprintf نجد printf و sprintf. فيما يلي الفروقات:

الفرق مع printf

printf يُستخدم لإخراج البيانات إلى الإخراج القياسي (عادةً وحدة التحكم). بينما fprintf يتيح تحديد وجهة الإخراج مما يجعله أكثر مرونة.

مثال: استخدام printf

printf("Hello, World!\n");

هذا سيُطبع دائمًا على وحدة التحكم.

مثال: استخدام fprintf

FILE *file = fopen("output.txt", "w");
fprintf(file, "Hello, World!\n");
fclose(file);

في هذه الحالة، يتم الكتابة إلى الملف المحدد output.txt.

الفرق مع sprintf

sprintf يختلف في أن وجهة الإخراج هي “سلسلة نصية” داخل الذاكرة.

مثال: استخدام sprintf

char buffer[50];
sprintf(buffer, "The result is %d", 42);

في هذه الحالة، ستُكتب السلسلة "The result is 42" داخل buffer.

الخلاصة

• fprintf دالة مرنة تسمح بتحديد وجهة الإخراج سواء كان ملفًا أو الإخراج القياسي.
• بالمقارنة مع printf و sprintf يمكن تحسين كفاءة البرنامج ووضوحه.

2. الاستخدام الأساسي لدالة fprintf

البنية (Syntax) والوسائط الأساسية

fprintf هي أداة مرنة لإخراج البيانات بتنسيق محدد. بنيتها الأساسية كالتالي:

int fprintf(FILE *stream, const char *format, ...);

فيما يلي شرح تفاصيل الوسائط:

1. FILE *stream

• يحدد مكان الكتابة.
• خيارات شائعة:
  • الإخراج القياسي (stdout)
  • إخراج الأخطاء القياسي (stderr)
  • ملف مفتوح بواسطة fopen

1. const char *format

• تعريف تنسيق الإخراج.
• باستخدام محددات التنسيق (%s, %d, %f …) يمكن التحكم في شكل النصوص والأعداد.

1. وسائط متغيرة (…)

• البيانات المراد طباعتها والمتوافقة مع محددات التنسيق.
• مثال: عند استخدام "Name: %s, Age: %d" يجب تمرير الاسم والعمر.

ترجع الدالة عدد الأحرف المكتوبة (عدد صحيح موجب). في حالة الخطأ تُرجع -1.

أمثلة أساسية على الكود

الإخراج إلى الإخراج القياسي

الإخراج إلى stdout مع التنسيق:

#include <stdio.h>

int main() {
    fprintf(stdout, "Hello, %s! You have %d new messages.\n", "Alice", 5);
    return 0;
}

النتيجة:

Hello, Alice! You have 5 new messages.

الإخراج إلى ملف

كتابة البيانات إلى ملف باستخدام fprintf:

#include <stdio.h>

int main() {
    FILE *file = fopen("output.txt", "w"); // فتح الملف بوضع الكتابة
    if (file == NULL) {
        fprintf(stderr, "Error opening file.\n");
        return 1;
    }

    fprintf(file, "Name: %s, Age: %d\n", "Bob", 30);
    fclose(file); // إغلاق الملف
    return 0;
}

محتوى الملف output.txt:

Name: Bob, Age: 30

أساسيات محددات التنسيق

يمكن التحكم في طريقة عرض البيانات باستخدام محددات التنسيق:

مثال:

fprintf(stdout, "Integer: %d, Float: %.2f, String: %s\n", 10, 3.14, "Test");

النتيجة:

Integer: 10, Float: 3.14, String: Test

3. الاستفادة من محددات التنسيق في fprintf

العرض (Minimum Width)

عند تحديد العرض، إذا كان عدد الأحرف أقل من العرض المطلوب، يتم ملء المسافة بالفراغات.

مثال:

fprintf(stdout, "|%10s|\n", "Hello");
fprintf(stdout, "|%10d|\n", 123);

النتيجة:

|     Hello|
|       123|

في هذا المثال، العرض هو 10. إذا كان النص أو الرقم أقصر، تضاف مسافات على اليسار.

الدقة (Precision)

تختلف وظيفة الدقة حسب نوع البيانات:

• النصوص (%s): يحدد الحد الأقصى لعدد الأحرف المطبوعة.
• الأعداد العشرية (%f, %e, %g): يحدد عدد الأرقام بعد الفاصلة العشرية.

مثال:

fprintf(stdout, "%.3f\n", 3.141592); // دقة للأعداد العشرية
fprintf(stdout, "%.5s\n", "Hello, World!"); // حد أقصى لطول النص

النتيجة:

3.142
Hello

الأعلام (Flags)

يمكن استخدام الأعلام للتحكم في محاذاة البيانات أو طريقة عرضها.

مثال:

fprintf(stdout, "|%-10s|%+05d|%#x|\n", "Left", 42, 42);

النتيجة:

|Left      |+0042|0x2a|

أمثلة عملية

باستخدام العرض والدقة والأعلام يمكن إنشاء جداول أو إخراج بيانات بشكل منظم.

إخراج البيانات في جدول

المثال التالي يعرض درجات الطلاب في جدول منسق:

#include <stdio.h>

int main() {
    fprintf(stdout, "|%-10s|%5s|%5s|%5s|\n", "Name", "Math", "Eng", "Sci");
    fprintf(stdout, "|%-10s|%5d|%5d|%5d|\n", "Alice", 95, 88, 92);
    fprintf(stdout, "|%-10s|%5d|%5d|%5d|\n", "Bob", 82, 79, 85);
    return 0;
}

النتيجة:

|Name      | Math|  Eng|  Sci|
|Alice     |   95|   88|   92|
|Bob       |   82|   79|   85|

تنسيق الأعداد

يمكن عرض الأعداد بشكل منسق لتسهيل القراءة.

مثال:

fprintf(stdout, "Price: $%8.2f\n", 1234.5);
fprintf(stdout, "Discount: %06d%%\n", 25);

النتيجة:

Price: $ 1234.50
Discount: 000025%

ملاحظات هامة

1. محددات غير صحيحة

• إذا لم يتطابق نوع البيانات مع محدد التنسيق، قد يحدث خطأ أو سلوك غير متوقع.
• مثال: تمرير نص إلى %d يؤدي إلى سلوك غير معرف.

1. العرض والدقة

• تحديد عرض كبير جدًا قد يجعل الإخراج طويلًا ويستهلك موارد إضافية.

الخلاصة

• باستخدام العرض والدقة والأعلام يمكن التحكم بشكل دقيق في إخراج fprintf.
• يساعد ذلك في إنشاء جداول أو تقارير بشكل منظم وسهل القراءة.
• من المهم التأكد من مطابقة نوع البيانات مع محدد التنسيق لتجنب الأخطاء.

4. التعامل مع الملفات باستخدام fprintf

طريقة فتح الملفات (fopen)

لاستخدام fprintf في الكتابة داخل ملف، يجب أولاً فتح الملف. في لغة C نستخدم الدالة fopen لفتح الملفات.

البنية الأساسية لـ fopen

FILE *fopen(const char *filename, const char *mode);

شرح الوسائط

• filename: اسم الملف (أو المسار الكامل) المطلوب فتحه.
• mode: يحدد وضع فتح الملف:
  • "r": للقراءة فقط
  • "w": للكتابة فقط (مع استبدال محتوى الملف إن وُجد)
  • "a": للإضافة إلى نهاية الملف (append)
  • "rb"/"wb"/"ab": للوضع الثنائي (binary)

القيمة المرجعة

• إذا نجح فتح الملف: تعيد المؤشر FILE*.
• إذا فشل: تعيد NULL.

مثال على استخدام fopen

#include <stdio.h>

int main() {
    FILE *file = fopen("example.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    fprintf(file, "Hello, World!\n");
    fclose(file);
    return 0;
}

هذا البرنامج يفتح ملفًا باسم example.txt ويكتب فيه نصًا ثم يغلقه.

الكتابة باستخدام fprintf

يمكن استخدام fprintf للكتابة داخل ملف مفتوح بتنسيق معين. فيما يلي بعض السيناريوهات:

كتابة أساسية إلى ملف

#include <stdio.h>

int main() {
    FILE *file = fopen("data.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    fprintf(file, "Name: %s, Age: %d\n", "Alice", 25);
    fprintf(file, "Name: %s, Age: %d\n", "Bob", 30);

    fclose(file);
    return 0;
}

محتوى data.txt:

Name: Alice, Age: 25
Name: Bob, Age: 30

إنشاء ملف CSV

مثال على كتابة البيانات بصيغة CSV (Comma-Separated Values):

#include <stdio.h>

int main() {
    FILE *file = fopen("students.csv", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    // السطر العلوي (الرؤوس)
    fprintf(file, "Name,Math,English,Science\n");

    // البيانات
    fprintf(file, "Alice,95,88,92\n");
    fprintf(file, "Bob,82,79,85\n");

    fclose(file);
    return 0;
}

محتوى students.csv:

Name,Math,English,Science
Alice,95,88,92
Bob,82,79,85

إغلاق الملفات (fclose)

بعد الانتهاء من العمل مع الملفات، يجب استخدام fclose لإغلاقها. إذا لم يتم ذلك قد تحدث مشاكل مثل:

• عدم كتابة جميع البيانات إلى الملف.
• إهدار موارد النظام.

البنية الأساسية لـ fclose

int fclose(FILE *stream);

القيمة المرجعة

• إذا نجح: تعيد 0.
• إذا فشل: تعيد EOF.

مثال على fclose

FILE *file = fopen("example.txt", "w");
if (file != NULL) {
    fprintf(file, "This is a test.\n");
    fclose(file);
}

نصائح للتعامل الآمن مع الملفات

1. التحقق من مؤشر الملف

• تحقق دائمًا من أن fopen لم يرجع NULL.

1. عدم نسيان إغلاق الملف

• بعد كل fopen يجب استدعاء fclose.

1. التعامل مع الأخطاء

• اكتشاف الأخطاء أثناء الكتابة أو القراءة والتصرف المناسب.
• مثال: نفاد مساحة القرص أو عدم وجود صلاحيات كافية.

الخلاصة

• قبل استخدام fprintf يجب فتح الملف باستخدام fopen، وبعد الانتهاء يجب إغلاقه باستخدام fclose.
• اختيار الوضع المناسب للملف (r/w/a) ومعالجة الأخطاء يضمن أمان العملية.
• يمكن استخدامه لتخزين بيانات بتنسيق CSV أو تسجيل الأحداث (Logs).

5. معالجة الأخطاء (Error Handling)

استخدام القيمة المرجعة من fprintf لاكتشاف الأخطاء

يمكن التحقق من القيمة المرجعة من fprintf لمعرفة ما إذا كانت عملية الكتابة نجحت أو فشلت.

مواصفات القيمة المرجعة

• إذا نجحت العملية: تعيد عدد الأحرف المكتوبة (عدد صحيح موجب).
• إذا فشلت العملية: تعيد -1.

مثال على فحص الأخطاء

#include <stdio.h>

int main() {
    FILE *file = fopen("output.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    int result = fprintf(file, "Hello, World!\n");
    if (result < 0) {
        fprintf(stderr, "Error: Failed to write to file.\n");
    }

    fclose(file);
    return 0;
}

في هذا المثال يتم التحقق من القيمة المرجعة. إذا كانت سالبة فهذا يعني أن الكتابة فشلت.

استخدام الإخراج القياسي للأخطاء (stderr)

stderr هو تدفق قياسي مخصص لطباعة الأخطاء والتحذيرات. من خلاله يمكن إعلام المستخدم أو المطور بوضوح عن وجود مشكلة.

مثال: طباعة الأخطاء باستخدام stderr

#include <stdio.h>

int main() {
    FILE *file = fopen("nonexistent_directory/output.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Unable to open file. Check the directory path.\n");
        return 1;
    }

    fclose(file);
    return 0;
}

النتيجة عند الخطأ:

Error: Unable to open file. Check the directory path.

ميزة stderr أنها تفصل رسائل الخطأ عن الإخراج العادي stdout.

أمثلة عملية لمعالجة الأخطاء

مثال: معالجة الأخطاء عند الكتابة وإغلاق الملف

#include <stdio.h>

int main() {
    FILE *file = fopen("output.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    // محاولة الكتابة
    if (fprintf(file, "Logging data: %d\n", 42) < 0) {
        fprintf(stderr, "Error: Failed to write to file.\n");
        fclose(file);
        return 1;
    }

    // التحقق عند الإغلاق
    if (fclose(file) != 0) {
        fprintf(stderr, "Error: Failed to close the file.\n");
        return 1;
    }

    printf("File operation completed successfully.\n");
    return 0;
}

النقاط المهمة:

1. التحقق عند فتح الملف والكتابة وإغلاقه.
2. إظهار رسائل مناسبة عند الفشل وإنهاء البرنامج بأمان.

الأخطاء الشائعة وكيفية معالجتها

1. فشل فتح الملف

الأسباب المحتملة:

• الملف غير موجود.
• المسار غير صحيح.
• عدم وجود صلاحيات كافية.

طرق المعالجة:

• التأكد من صحة المسار.
• تصحيح الصلاحيات.
• التحقق من القيمة المرجعة من fopen.

2. فشل عملية الكتابة

الأسباب:

• نفاد مساحة التخزين.
• فتح الملف بوضع القراءة فقط.

طرق المعالجة:

• التأكد من فتح الملف بوضع مناسب مثل "w" أو "a".
• التحقق من وجود مساحة كافية على القرص.

3. فشل عند إغلاق الملف

الأسباب:

• نقص في موارد النظام.
• مشكلة في العتاد (hardware issue).

طرق المعالجة:

• التحقق من القيمة المرجعة من fclose.
• فتح الملفات فقط عند الحاجة لتقليل استهلاك الموارد.

الخلاصة

• التحقق من القيمة المرجعة من fprintf ضروري لاكتشاف الأخطاء.
• استخدام stderr يجعل رسائل الخطأ واضحة ومنفصلة عن الإخراج العادي.
• التعامل مع الأخطاء بشكل صحيح يزيد من موثوقية البرنامج.

6. أمثلة تطبيقية (Use Cases)

إنشاء ملفات السجل (Log Files)

ملفات السجل تُستخدم لتسجيل حالة تشغيل البرنامج أو الأخطاء. المثال التالي يوضح كيفية إضافة التاريخ والوقت في السجل.

مثال: إخراج سجل يحتوي على التاريخ والوقت

#include <stdio.h>
#include <time.h>

int main() {
    FILE *logFile = fopen("log.txt", "a"); // فتح الملف بوضع الإضافة
    if (logFile == NULL) {
        fprintf(stderr, "Error: Could not open log file.\n");
        return 1;
    }

    time_t now = time(NULL);
    struct tm *localTime = localtime(&now);

    fprintf(logFile, "[%04d-%02d-%02d %02d:%02d:%02d] Program started\n",
            localTime->tm_year + 1900, localTime->tm_mon + 1, localTime->tm_mday,
            localTime->tm_hour, localTime->tm_min, localTime->tm_sec);

    fclose(logFile);
    return 0;
}

محتوى log.txt:

[2025-01-19 15:45:30] Program started

النقاط المهمة

• باستخدام time.h نحصل على التاريخ والوقت الحاليين.
• الوضع "a" يضيف السجلات إلى نهاية الملف بدلاً من استبداله.

كتابة البيانات في شكل جدول

يمكن استخدام fprintf لإخراج البيانات بشكل مرتب في جداول، مثل تقارير أو نتائج.

مثال: جدول درجات الطلاب

#include <stdio.h>

int main() {
    FILE *file = fopen("report.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    fprintf(file, "|%-10s|%6s|%6s|%6s|\n", "Name", "Math", "Eng", "Sci");
    fprintf(file, "|%-10s|%6d|%6d|%6d|\n", "Alice", 90, 85, 88);
    fprintf(file, "|%-10s|%6d|%6d|%6d|\n", "Bob", 78, 82, 80);

    fclose(file);
    return 0;
}

محتوى report.txt:

|Name      | Math|  Eng|  Sci|
|Alice     |   90|   85|   88|
|Bob       |   78|   82|   80|

النقاط المهمة

• استخدام المحاذاة لليسار %-10s والمحاذاة لليمين %6d لتنسيق الأعمدة.

حفظ البيانات بصيغة CSV

صيغة CSV (Comma-Separated Values) مفيدة للتخزين أو مشاركة البيانات مع برامج أخرى مثل Excel أو Python.

مثال: حفظ البيانات في CSV

#include <stdio.h>

int main() {
    FILE *file = fopen("data.csv", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    // كتابة رؤوس الأعمدة
    fprintf(file, "Name,Math,English,Science\n");

    // كتابة البيانات
    fprintf(file, "Alice,90,85,88\n");
    fprintf(file, "Bob,78,82,80\n");

    fclose(file);
    return 0;
}

محتوى data.csv:

Name,Math,English,Science
Alice,90,85,88
Bob,78,82,80

النقاط المهمة

• الفواصل , تجعل البيانات قابلة للقراءة في أدوات مختلفة.

تسجيل معلومات التصحيح (Debug)

يمكن تخزين بيانات التصحيح لمتابعة حالة البرنامج أثناء التشغيل.

مثال: تسجيل قيمة متغير

#include <stdio.h>

int main() {
    FILE *debugFile = fopen("debug.log", "w");
    if (debugFile == NULL) {
        fprintf(stderr, "Error: Could not open debug log file.\n");
        return 1;
    }

    int x = 42;
    fprintf(debugFile, "Debug: Variable x = %d\n", x);

    fclose(debugFile);
    return 0;
}

محتوى debug.log:

Debug: Variable x = 42

النقاط المهمة

• تسجيل بيانات التصحيح يساعد على اكتشاف الأخطاء في البرامج المعقدة.

الخلاصة

• باستخدام fprintf يمكن إنشاء ملفات سجل، جداول، أو ملفات CSV.
• السجلات مع الطابع الزمني (timestamp) أو CSV هي الأكثر استخدامًا في المشاريع العملية.
• هذه الأمثلة تساعد في الاستفادة الفعّالة من fprintf في مواقف متعددة.

7. الأسئلة الشائعة (FAQ)

1. ما الفرق بين fprintf و printf؟

الإجابة

• printf:
• يُخرج البيانات إلى الإخراج القياسي (عادةً وحدة التحكم).
• لا يمكن تغيير وجهة الإخراج.
• fprintf:
• يسمح بتحديد وجهة الإخراج بحرية (مثل: ملف، stdout، stderr).
• أكثر مرونة في إخراج البيانات.

مثال

#include <stdio.h>

int main() {
    printf("This is printed to the console.\n"); // دائمًا على وحدة التحكم

    FILE *file = fopen("output.txt", "w");
    if (file != NULL) {
        fprintf(file, "This is written to a file.\n"); // يكتب في ملف
        fclose(file);
    }
    return 0;
}

2. كيف يمكن طباعة النصوص اليابانية (أو متعددة اللغات) باستخدام fprintf؟

الإجابة

• لطباعة النصوص بشكل صحيح يجب التأكد من:

1. ترميز الأحرف (Character Encoding):
   • استخدام UTF-8 أو Shift-JIS حسب البيئة.
2. إعداد الترميز عند إنشاء الملف:
   • يجب أن يتوافق الترميز المستخدم عند الكتابة مع بيئة التشغيل.

مثال: إخراج نص UTF-8

#include <stdio.h>
#include <locale.h>

int main() {
    setlocale(LC_ALL, ""); // إعداد البيئة المحلية

    FILE *file = fopen("japanese.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    fprintf(file, "こんにちは、世界！\n");
    fclose(file);
    return 0;
}

ملاحظة:

• في بعض البيئات (خاصة Windows) قد تحتاج لتحديد الترميز بوضوح لتجنب ظهور رموز غير مفهومة.

3. ما هي الأسباب الشائعة لحدوث أخطاء مع fprintf؟

الإجابة

• تشمل الأسباب الرئيسية:

1. فشل فتح الملف:
   • المسار غير صحيح.
   • الملف غير موجود.
   • عدم وجود صلاحيات كافية.
2. نفاد مساحة التخزين:
   • لا توجد مساحة كافية على القرص أثناء الكتابة.
3. عدم تطابق محدد التنسيق مع نوع البيانات:
   • تمرير عدد صحيح إلى %s مثلاً.

مثال: خطأ بسبب محدد تنسيق غير صحيح

#include <stdio.h>

int main() {
    FILE *file = fopen("error.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    // خطأ: استخدام %s مع عدد صحيح
    fprintf(file, "%s", 42);
    fclose(file);
    return 0;
}

الحل:

• تأكد من مطابقة نوع البيانات مع محدد التنسيق المناسب (%d للأعداد الصحيحة، %s للنصوص).

4. ما هو تأثير الـ Buffering في fprintf؟

الإجابة

• التخزين المؤقت (Buffering): البيانات لا تُكتب مباشرة في الملف بل تُخزن مؤقتًا حتى يتم ملء الذاكرة المؤقتة أو استدعاء fclose أو fflush.
• المشكلة: إذا توقف البرنامج فجأة قد تُفقد البيانات المخزنة مؤقتًا.

الحل

1. استخدام fflush:
   • لإجبار البرنامج على كتابة البيانات فورًا إلى الملف.

مثال: استخدام fflush

#include <stdio.h>

int main() {
    FILE *file = fopen("buffered_output.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    fprintf(file, "Buffered data.\n");
    fflush(file); // كتابة البيانات مباشرة

    fclose(file);
    return 0;
}

5. ماذا أفعل إذا توقفت عملية إخراج الملف في منتصفها؟

الإجابة

• الأسباب المحتملة:

1. نسيان إغلاق الملف:
   • قد لا تُكتب البيانات المخزنة مؤقتًا.
2. نفاد مساحة التخزين:
   • لا توجد مساحة كافية أثناء الكتابة.

مثال: إغلاق الملف بشكل صحيح

#include <stdio.h>

int main() {
    FILE *file = fopen("partial_output.txt", "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open file.\n");
        return 1;
    }

    fprintf(file, "This is complete data.\n");

    // لا تنسَ إغلاق الملف
    fclose(file);
    return 0;
}

الحلول:

• استخدام fclose دائمًا بعد الانتهاء من الكتابة.
• التحقق من القيم المرجعة عند حدوث خطأ.

الخلاصة

• fprintf قوية ومرنة لكنها تتطلب عناية في التعامل مع الترميز والأخطاء.
• اتباع نصائح FAQ يساعد على تجنب المشاكل الشائعة.

8. الإخراج إلى ملفات متعددة في نفس الوقت

fprintf يمكن استخدامه للكتابة إلى أكثر من ملف في آن واحد. هذا القسم يوضح طرق التعامل مع عدة ملفات بشكل عملي.

البنية الأساسية للتعامل مع ملفات متعددة

في لغة C يمكن فتح عدة مؤشرات ملفات (FILE*) والعمل عليها بالتوازي. لكل ملف يجب استدعاء fopen و fprintf و fclose بشكل منفصل.

مثال أساسي: الكتابة في ملفين

#include <stdio.h>

int main() {
    // فتح ملفين
    FILE *file1 = fopen("output1.txt", "w");
    FILE *file2 = fopen("output2.txt", "w");

    if (file1 == NULL || file2 == NULL) {
        fprintf(stderr, "Error: Could not open one of the files.\n");
        if (file1) fclose(file1);
        if (file2) fclose(file2);
        return 1;
    }

    // الكتابة في الملف الأول
    fprintf(file1, "This is the first file.\n");

    // الكتابة في الملف الثاني
    fprintf(file2, "This is the second file.\n");

    // إغلاق الملفات
    fclose(file1);
    fclose(file2);

    printf("Data written to both files successfully.\n");
    return 0;
}

محتوى output1.txt:

This is the first file.

محتوى output2.txt:

This is the second file.

النقاط المهمة

1. التحقق من الأخطاء: يجب التحقق من نجاح fopen لكل ملف.
2. إدارة الموارد: يجب إغلاق جميع الملفات باستخدام fclose.

التعامل الديناميكي مع الملفات

يمكن إنشاء أسماء ملفات ديناميكيًا والكتابة إلى كل واحد منها في حلقة.

مثال: إنشاء أسماء ملفات ديناميكية

#include <stdio.h>

int main() {
    char filename[20];
    for (int i = 1; i <= 3; i++) {
        // إنشاء اسم ملف ديناميكي
        sprintf(filename, "file%d.txt", i);

        FILE *file = fopen(filename, "w");
        if (file == NULL) {
            fprintf(stderr, "Error: Could not open %s\n", filename);
            continue; // الانتقال للملف التالي
        }

        fprintf(file, "This is file number %d\n", i);
        fclose(file);
    }

    printf("Data written to files successfully.\n");
    return 0;
}

الملفات الناتجة:

• file1.txt: This is file number 1
• file2.txt: This is file number 2
• file3.txt: This is file number 3

النقاط المهمة

• استخدام sprintf لإنشاء أسماء الملفات.
• معالجة الأخطاء لكل ملف على حدة.

الكتابة المتوازية (Parallel Writing)

في حال الرغبة في الكتابة إلى عدة ملفات بكميات كبيرة من البيانات يمكن الاستفادة من الخيوط (Threads).

مثال: الكتابة باستخدام pthread

#include <stdio.h>
#include <pthread.h>

void *write_to_file(void *arg) {
    char *filename = (char *)arg;
    FILE *file = fopen(filename, "w");
    if (file == NULL) {
        fprintf(stderr, "Error: Could not open %s\n", filename);
        return NULL;
    }

    fprintf(file, "Data written to %s\n", filename);
    fclose(file);
    return NULL;
}

int main() {
    pthread_t threads[3];
    char *filenames[] = {"thread1.txt", "thread2.txt", "thread3.txt"};

    for (int i = 0; i < 3; i++) {
        pthread_create(&threads[i], NULL, write_to_file, filenames[i]);
    }

    for (int i = 0; i < 3; i++) {
        pthread_join(threads[i], NULL);
    }

    printf("Data written to all files in parallel.\n");
    return 0;
}

الملفات الناتجة:

• thread1.txt: Data written to thread1.txt
• thread2.txt: Data written to thread2.txt
• thread3.txt: Data written to thread3.txt

النقاط المهمة

• باستخدام الخيوط يمكن الكتابة لعدة ملفات في وقت واحد.
• يجب استخدام pthread_join لمزامنة الخيوط.

الخلاصة

• fprintf يسمح بالكتابة في ملفات متعددة في نفس البرنامج.
• يمكن إنشاء أسماء ملفات ديناميكيًا أو استخدام الخيوط لزيادة الأداء.
• إدارة الموارد بشكل صحيح (إغلاق الملفات + معالجة الأخطاء) أمر أساسي.

9. روابط مرجعية

• Programming Place Plus – دالة fprintf
• مرجع لغة C (باليابانية)