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

من موسوعة حسوب
< Ruby‏ | IO
لا ملخص تعديل
ط مراجعة وتدقيق.
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>binwrite‎</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع <code>IO.binwrite‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
[[تصنيف: Ruby IO]]
<code>binwrite</code> مشابه للتابع <code>[[Ruby/IO/write|write]]</code>، ما عدا أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT ‏("<code>wb: ASCII-8BIT‏</code>")‏.
يشبه التابع <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
<syntaxhighlight lang="ruby">binwrite(name, string, [offset] ) → integer
سطر 9: سطر 9:
==المعاملات==
==المعاملات==
===<code>name‎</code>===
===<code>name‎</code>===
اسم الملف
اسم الملف المراد الكتابة فيه.
===<code>string‎</code>===
===<code>string‎</code>===
[[Ruby/String|سلسلة نصية]]
[[Ruby/String|سلسلة نصية]] يراد كتابتها ضمن الملف <code>name</code>.
===<code>offset‎</code>===
===<code>offset‎</code>===
عدد صحيح يمثل الإزاحة
عدد صحيح يمثل مقدار إزاحة مؤشر المجرى في الملف الذي ستبدأ عنده عملية الكتابة بدءًا من الموضع الحالي.
===<code>open_args‎</code>===
===<code>open_args‎</code>===
خيارات الفتح,
خيارات فتح الملف للكتابة فيه.


==القيمة المُعادة==
==القيمة المعادة==
يعيد التابع <code>binwrite</code> عددا صحيحا.
يعاد عددٌ صحيحٌ يمثِّل عدد البايتات التي كتبت ضمن الملف <code>name</code>.


==انظر أيضا==
==انظر أيضًا==
* التابع <code>[[Ruby/IO/binread|binread]]</code>: يفتح التابع <code>binread</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‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 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: يفتح الملف ثم يحرِّك موضع المؤشر بمقدار محدد (في حال إعطائه) ثم يجلب جميع محتوى الملف بدءًا من موضع المؤشر وحتى نهاية الملف أو يجلب حجم محدَّد من البيانات.

مصادر