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

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

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

يتأكد التابع binread من إغلاق الملف قبل إنهاية العملية. يفتح التابع الملف في الوضع "rb:ASCII-8BIT".

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

binread(name, [length [, offset]] )→ string‎

المعاملات

`name‎`

اسم الملف المراد فتحه وجلب البيانات منه.

`length‎`

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

`offset‎`

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

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

تعاد سلسلة نصية تحوي البيانات التي قُرأَت من الملف ذي الاسم name والتي تمتد بدءًا من موضع الموشر الحالي (وبعد إزاحته بمقدار offset إن أعطي هذا المعامل) وحتى length بايت (إن أعطي هذا المعامل) أو حتى نهاية الملف.

أمثلة

مثال على استخدام التابع binread‎:

IO.binread("testfile")           #=> "This is line one\nThis is line two\nThis is line three\nAnd so on...\n"
IO.binread("testfile", 20)       #=> "This is line one\nThi"
IO.binread("testfile", 20, 10)   #=> "ne one\nThis is line "‎

انظر أيضًا

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>binread‎</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>IO.binread‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby IO]]
-يفتح التابع <code>binread</code> الملف، ثم يتموضع اختياريا في الموضع المعطى <code>offset</code> (انظر فقرة البنية العامة)، ثم يُعيد <code>length</code> بايت (تساوي قيمته الافتراضية طول بقية الملف). يضمن التابع <code>binread</code> أن يُغلق الملف قبل العودة. وضع الفتح سيكون "rb:ASCII-8BIT".
+يفتح التابع <code>binread</code> الملف ثم يحرِّك موضع المؤشر بمقدار محدد (في حال إعطائه) ثم يجلب جميع محتوى الملف بدءًا من موضع المؤشر وحتى نهاية الملف أو يجلب حجم محدَّد من البيانات.
+يتأكد التابع <code>binread</code> من إغلاق الملف قبل إنهاية العملية. يفتح التابع الملف في الوضع "<code>rb:ASCII-8BIT</code>".
 ==البنية العامة==
 <syntaxhighlight lang="ruby">binread(name, [length [, offset]] )→ string‎</syntaxhighlight>
 ==المعاملات==
 ===<code>name‎</code>===
-اسم على هيئة [[Ruby/String|سلسلة نصية]]
+اسم الملف المراد فتحه وجلب البيانات منه.
 ===<code>length‎</code>===
+عدد صحيح يمثل عدد البايتات المراد جلبها من الملف. القيمة الافتراضية هي قراءة وجلب البيانات بدءًا من موضع الموشر الحالي (وبعد إزاحته بمقدار <code>offset</code> إن أعطي هذا المعامل) وحتى نهاية الملف.
 ===<code>offset‎</code>===
-==القيمة المُعادة==
+عدد صحيح يمثل مقدار إزاحة مؤشر المجرى في الملف الذي ستبدأ عنده عملية قراءة وجلب البيانات بدءًا من الموضع الحالي.
+==القيمة المعادة==
+تعاد سلسلة نصية تحوي البيانات التي قُرأَت من الملف ذي الاسم <code>name</code> والتي تمتد بدءًا من موضع الموشر الحالي (وبعد إزاحته بمقدار <code>offset</code> إن أعطي هذا المعامل) وحتى <code>length</code> بايت (إن أعطي هذا المعامل) أو حتى نهاية الملف.
 ==أمثلة==
 مثال على استخدام التابع <code>binread‎</code>:
@@ سطر 17: / سطر 25: @@
 IO.binread("testfile", 20)       #=> "This is line one\nThi"
 IO.binread("testfile", 20, 10)   #=> "ne one\nThis is line "‎</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
-* التابع <code>[[Ruby/IO/binwrite|binwrite]]</code>: التابع <code>binwrite</code> مشابه للتابع <code>IO.write</code>X، ما عدا أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT ‏("wb: ASCII-8BIT‏")‏.
+* التابع <code>[[Ruby/IO/binwrite|binwrite]]</code>: يشبه التابع <code>[[Ruby/IO/write|write]]</code> باستثناء أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-binread قسم  التابع binread‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-binread قسم التابع binread‎ في الصنف IO‎ في توثيق روبي الرسمي.]