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

مصادر