كتلة الوظيفة FS_WRITE

تكتب كتلة الوظيفة FS_WRITE البيانات على نظام الملفات.

تحذير: سيتم استبدال الملفات الموجودة مسبقًا دون أي تحذير.

يجب أن يتم تهيئة نظام الملفات مسبقًا باستخدام FS_INIT. يتم تنفيذ جميع العمليات بشكل غير متزامن لكل وسائط تخزين تم إنشاؤها.

مدخل WRITE

عند حافة إيجابية، يتم كتابة البيانات على وسيط التخزين.

مدخل DEV

يحدد الجهاز الذي سيتم الوصول إلى الملفات منه. يتم استخدام الجهاز لكل مشروع ويمكن إدارتة في قائمة السياق تحت المشروع ▸ التخزين الخارجي.

مدخل PATH

يحدد المسار إلى الملف على وسيط التخزين. يتوافق المسار مع مسار ملف يونكس في تنسيق UTF-8، إذا تم دعمه. يتم تمثيل المسار كما يلي:

المجلد/المجلد الفرعي/الملف.txt

مدخل DATA

يحدد البيانات التي يجب كتابتها.

مدخل MODE

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

الوضع	الوصف
"r"	مفتوح فقط للقراءة. يضع مؤشر الملف في بداية الملف.
"r+"	مفتوح فقط للقراءة والكتابة. يضع مؤشر الملف في بداية الملف.
"w"	مفتوح فقط للكتابة. يضع مؤشر الملف في بداية الملف. يمحو محتوى الملف. إذا لم يكن الملف موجودًا، يتم إنشاؤه.
"w+"	مفتوح فقط للكتابة والقراءة. يضع مؤشر الملف في بداية الملف. يمحو محتوى الملف. إذا لم يكن الملف موجودًا، يتم إنشاؤه.
"a"	مفتوح فقط للكتابة. يضع مؤشر الملف في نهاية الملف. إذا لم يكن الملف موجودًا، يتم إنشاؤه. يتم إضافة البيانات في النهاية.
"a+"	مفتوح فقط للكتابة والقراءة. يضع مؤشر الملف في نهاية الملف. إذا لم يكن الملف موجودًا، يتم إنشاؤه. يتم إضافة البيانات في النهاية.
"x"	مفتوح فقط للكتابة. يضع مؤشر الملف في بداية الملف. إذا كان الملف موجودًا، يتم الإنهاء.
"x+"	مفتوح فقط للكتابة والقراءة. يضع مؤشر الملف في بداية الملف. إذا كان الملف موجودًا، يتم الإنهاء.
"c"	مفتوح فقط للكتابة. يضع مؤشر الملف في بداية الملف. إذا لم يكن الملف موجودًا، يتم إنشاؤه. يحل محل محتوى الملف.
"c+"	مفتوح فقط للكتابة والقراءة. يضع مؤشر الملف في بداية الملف. إذا لم يكن الملف موجودًا، يتم إنشاؤه. يحل محل محتوى الملف.

مدخل BOM

إذا كان المدخل صحيحًا عند الكتابة، يتم إضافة UTF-8 Byte Order Mark في بداية الملف. يحدث ذلك فقط إذا تم استبدال الملف أو إنشاؤه جديدًا. إذا لم يتم كتابة BOM في بداية الملف، لا يمكن إضافته لاحقًا.

مخرج DONE

يقدم المخرج نبضة عند النجاح لإجراء العملية التالية. تحدث النبضة عند إنهاء العملية، حتى لو حدث خطأ ما.

مخرج LENGTH

يعيد عدد البايتات المكتوبة. يتم تخزين الحالة للاستخدام اللاحق.

مخرج ERROR

في حالة الخطأ، يعيد نصًا يحتوي على رسالة خطأ. وهو FALSE إذا لم يحدث أي خطأ. يتم تخزين الحالة للاستخدام اللاحق.

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

• لم يتم تشغيل خدمة وسائط التخزين.
• لم يتم تهيئة التخزين.
• بيانات تسجيل الدخول غير صالحة.
• لم يمكن الوصول إلى الخادم البعيد.
• وسيط التخزين غير موجود.
• المسار المحدد غير صالح.
• لا يمكن الكتابة على وسائط التخزين.
• لا يوجد مساحة تخزين متاحة على وسائط التخزين أو أنها محمية من الكتابة.