واجهة الملفات النصية

واجهة النص الكامل للملف

يدعم المتصفح وتنفيذ لبات 0.7.0 الأصلي الدالتين المضمنتين. لا تحتاجان استيرادا أو علامة غير_آمن/unsafe. استخدام unsafe مع أي منهما خطأ مصدر unsafe-on-safe-call.

تحفظ القراءة كل بايت محتوى، بما فيه BOM وCRLF وNUL والتطبيع. تعيد الملفات الفارغة success(""). يعيد UTF-8 غير الصالح invalid-utf8. تستخدم الكتابة بايتات UTF-8 الدقيقة للنص، ولا تضيف سطرا جديدا، وتستبدل المحتوى بدلا من إلحاقه. افحص ok قبل قراءة value أو error؛ لا تحتوي الكتابة الناجحة على value قابلة للقراءة.

يسمي عرض خرج المتصفح محارف التحكم غير المرئية مثل BOM وNUL، ويعرض CRLF كفاصل سطر. لا يغير هذا العرض الآمن محتوى الملف. استخدم تنزيل الملفات لمقارنة البايتات الدقيقة.

دعم المضيف لكل عملية

لا تتبع المسارات الأصلية مجلد ملف المصدر. لا يوجد توسيع صدفة لـ~ أو المتغيرات أو أحرف البدل، ولا إنشاء ضمني للمجلدات الأم. تتبع القراءة حل نظام الملفات المعتاد بما فيه الروابط الرمزية، لكنها ترفض المجلدات والأجهزة والأنابيب بسبب not-regular-file. تستبدل الكتابة الناجحة المدخل الأخير، بما فيه الرابط الرمزي الأخير، بدلا من اتباعه. تحفظ الكتابة الفاشلة الوجهة السابقة؛ ولا يلغي توقف لاحق كتابة مكتملة.

ترفض أسماء المتصفح / والشرطة المائلة العكسية وNUL ومحارف التحكم U+0000 حتى U+001F وU+007F حتى U+009F والاسمين . و... لا توجد مجلدات. يقبل المخزن 64 ملفا و8388608 بايتا إجمالا. لكل تشغيل أيضا ميزانية نقل تحديثات كتابة قدرها 8388608 بايتا، تحسب بايتات الاسم والمحتوى و64 بايتا إضافيا لكل كتابة؛ تستهلك الاستبدالات المتكررة هذه الميزانية أيضا. تتبع القراءة والكتابة هذه القيود مستقلة عن لغة الشرح أو المصدر.

أخطاء الملف القابلة للاسترداد

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

ملفات التشغيل المؤقتة والمصدر المحفوظ

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

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

استخدم زر التنزيل الصريح لكل ملف مستورد أو مكتوب بنجاح. يحفظ التنزيل اسمه وبايتاته الدقيقة، بما فيها بايتات مستوردة ليست UTF-8. لا يجعل استيراد helper.aspl كبيانات تشغيل منه وحدة مصدر أصلية، ولا يتيح استيراد المصدر في المتصفح.

الأمثلة الكاملة والنطاق

يحتاج مثال القراءة الافتراضي سطر إدخال واحدا missing.txt ولا يحتاج ملفا مستوردا. يطبع فرع not-found خطأ ويعيد 0. لا يحتاج مثال الكتابة إدخالا أو أصلا؛ ينشئ generated.txt أو يستبدله بالبايتات الدقيقة generated\n، ثم يطبع Output: saved\n.

دالة ابدأ_الرئيسية() -> ص64 {
    اطبع("File: ").
    دع الاسم = اقرأ_سطر().
    دع المحتوى: نتيجة<نص> = اقرأ_ملف_نصي(الاسم).
    إذا (المحتوى::نجاح) {
        اطبع(المحتوى::قيمة).
    } وإلا {
        اطبع("error: ").
        اطبع(المحتوى::الخطأ::الرمز).
        اطبع("\س").
    }
    أرجع 0.
}

{
  "browser": {
    "check": "success",
    "class": "success",
    "output": "File: error: not-found\n",
    "processStatus": 0
  },
  "native": {
    "check": 0,
    "status": 0,
    "output": "File: error: not-found\n"
  }
}

دالة ابدأ_الرئيسية() -> ص64 {
    اطبع("Output: ").
    دع المحفوظ: نتيجة<وحدة> = اكتب_ملف_نصي("generated.txt", "generated\س").
    إذا (المحفوظ::نجاح) {
        اطبع("saved\س").
    } وإلا {
        اطبع("error: ").
        اطبع(المحفوظ::الخطأ::الرمز).
        اطبع("\س").
    }
    أرجع 0.
}

{
  "browser": {
    "check": "success",
    "class": "success",
    "output": "Output: saved\n",
    "fileUpdates": [
      {
        "name": "generated.txt",
        "content": "generated\n"
      }
    ],
    "processStatus": 0
  },
  "native": {
    "check": 0,
    "status": 0,
    "output": "Output: saved\n"
  }
}

اقرأ الدليل العملي قبل تجربة قراءة ناجحة أو حفظ البايتات المولدة. تحفظ صفحتا القراءة والكتابة الكاملتان الصيغتين العربية والإنجليزية المورّدتين. توسع هذه الواجهات MVP التاريخي؛ لا تعرف المواصفة المؤرشفة سلوكها الحالي في المضيفين.