الفرق بين المراجعتين لصفحة: «Ruby/IO/binwrite»

المراجعة الحالية بتاريخ 12:04، 19 ديسمبر 2018

يشبه التابع binwrite التابع write باستثناء أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT ‏("wb: ASCII-8BIT‏")‏.

البنية العامة

binwrite(name, string, [offset] ) → integer
binwrite(name, string, [offset], open_args )  → integer‎

المعاملات

`name‎`

اسم الملف المراد الكتابة فيه.

`string‎`

سلسلة نصية يراد كتابتها ضمن الملف name.

`offset‎`

عدد صحيح يمثل مقدار إزاحة مؤشر المجرى في الملف الذي ستبدأ عنده عملية الكتابة بدءًا من الموضع الحالي.

`open_args‎`

خيارات فتح الملف للكتابة فيه.

القيمة المعادة

يعاد عددٌ صحيحٌ يمثِّل عدد البايتات التي كتبت ضمن الملف name.

انظر أيضًا

التابع binread: يفتح الملف ثم يحرِّك موضع المؤشر بمقدار محدد (في حال إعطائه) ثم يجلب جميع محتوى الملف بدءًا من موضع المؤشر وحتى نهاية الملف أو يجلب حجم محدَّد من البيانات.

مصادر

قسم التابع binwrite‎ في الصنف IO‎ في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>binwrite‎</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>IO.binwrite‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby IO]]
-التابع <code>binwrite</code> مشابه للتابع <code>IO.write</code>X، ما عدا أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT ‏("wb: ASCII-8BIT‏")‏.
+يشبه التابع <code>binwrite</code> التابع <code>[[Ruby/IO/write|write]]</code> باستثناء أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT ‏("<code>wb: ASCII-8BIT‏</code>")‏.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">binwrite(name, string, [offset] ) → integer
@@ سطر 9: / سطر 9: @@
 ==المعاملات==
 ===<code>name‎</code>===
-اسم الملف
+اسم الملف المراد الكتابة فيه.
 ===<code>string‎</code>===
-[[Ruby/String|سلسلة نصية]]
+[[Ruby/String|سلسلة نصية]] يراد كتابتها ضمن الملف <code>name</code>.
 ===<code>offset‎</code>===
-عدد صحيح يمثل الإزاحة
+عدد صحيح يمثل مقدار إزاحة مؤشر المجرى في الملف الذي ستبدأ عنده عملية الكتابة بدءًا من الموضع الحالي.
 ===<code>open_args‎</code>===
-==القيمة المُعادة==
+خيارات فتح الملف للكتابة فيه.
-==انظر أيضا==
-* التابع <code>[[Ruby/IO/binread|binread]]</code>: يفتح التابع <code>binread</code> الملف، ثم يتموضع اختياريا في الموضع المعطى <code>offset</code> (انظر فقرة البنية العامة)، ثم يُعيد <code>length</code> بايت (تساوي قيمته الافتراضية طول بقية الملف). يضمن التابع <code>binread</code> أن يُغلق الملف قبل العودة. وضع الفتح سيكون "rb:ASCII-8BIT".
+==القيمة المعادة==
-* التابع <code>[[Ruby/IO/copy_stream|copy_stream]]</code>: ينسخ التابع <code>[[Ruby/IO/copy_stream|::copy_stream]]</code> المصدر المعطى <code>src</code> إلى <code>dst</code> (انظر فقرة البنية العامة). الوسيطان <code>src</code> و <code>dst</code> يمكن أن يكونا إما اسماء ملفات، أو كائن مشابهة للصنف IO. يجب أن يكون للكائنات المشابهة لـ IO بالنسبة للوسيط <code>src</code> التابع <code>[[Ruby/IO/readpartial|readpartial]]</code> أو <code>[[Ruby/IO/read-i|read]]</code>. كما يجب أن يكون للكائنات المشابهة لـ IO بالنسبة للوسيط <code>dst</code> التابع <code>[[Ruby/IO/write-i|write]]</code>. (يمكن استخدام الآليات خاصة، مثل استدعاء نظام sendfile، في بعض الحالات المناسبة.)
+يعاد عددٌ صحيحٌ يمثِّل عدد البايتات التي كتبت ضمن الملف <code>name</code>.
+==انظر أيضًا==
+* التابع <code>[[Ruby/IO/binread|binread]]</code>: يفتح الملف ثم يحرِّك موضع المؤشر بمقدار محدد (في حال إعطائه) ثم يجلب جميع محتوى الملف بدءًا من موضع المؤشر وحتى نهاية الملف أو يجلب حجم محدَّد من البيانات.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-binwrite قسم  التابع binwrite‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-binwrite قسم التابع binwrite‎ في الصنف IO‎ في توثيق روبي الرسمي.]