وظيفة يكتب قيمة معلمة سلسلة من نوع إلى ملف BIN، CSV أو TXT بدءا من الموقف الحالي للمؤشر الملف. عند الكتابة إلى ملف CSV أو TXT: إذا كان هناك رمز في سلسلة '\ ن' (LF) دون الحرف السابق '\ ص "(CR)، ثم قبل' \ ن 'المفقودين' \ ص" يضاف.
UINT FileWriteString (
الباحث file_handle، // التعامل مع الملف
سلسلة CONST text_string، // سلسلة لكتابة
الباحث طول = 0 // عدد من الرموز
)؛
المعلمات
file_handle
[في] اصف ملف إرجاعها بواسطة File**** () .
text_string
[في] سلسلة.
طول = 0
[في] عدد الأحرف التي تريد الكتابة. هناك حاجة إلى هذا الخيار لكتابة سلسلة إلى ملف BIN. إذا لم يتم تحديد الحجم، ثم يتم كتابة السلسلة بأكملها دون مقطورة 0. إذا قمت بتحديد حجم أصغر من طول السلسلة، ثم جزء من سلسلة بدون مقطورة 0 هو مكتوب. إذا قمت بتحديد حجم أكبر من طول السلسلة، ويتم تعبئة سلسلة من العدد المناسب من الأصفار. لملفات CSV ونوع TXT، يتم تجاهل هذه المعلمة ويتم كتابة سلسلة تماما.
عودة القيمة
إذا نجحت ترجع الدالة عدد البايتات مكتوبة أو 0 في حالة الخطأ. للحصول على معلومات حول الخطأ دعوة يقوم GetlastError () وظيفة. هو تحول مؤشر ملف بنفس عدد وحدات البايت.
ملاحظة
لاحظ أنه عند الكتابة إلى ملف تم فتحه من قبل FILE_UNICODE العلم (أو من دون علم FILE_ANSI)، ثم عدد البايتات المكتوبة سيكون ضعفي عدد الأحرف سلسلة كتب. عند التسجيل لملف تم فتحه مع العلم FILE_ANSI، وعدد من وحدات البايت المكتوبة يتزامن مع عدد من الشخصيات سلسلة مكتوب.