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