الفرق بين المراجعتين ل"Ruby/IO/binread"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>binread</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف:...') |
|||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
| − | يفتح التابع <code>binread</code> الملف، ثم يتموضع | + | يفتح التابع <code>binread</code> الملف، ثم يتموضع عند موضع الإزاحة <code>offset</code> (انظر فقرة البنية العامة) في حال إعطائه، ثم يُعيد <code>length</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>binread</code> سلسلة نصية. | ||
| + | |||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>binread</code>: | مثال على استخدام التابع <code>binread</code>: | ||
| سطر 18: | سطر 28: | ||
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>binwrite</code> مشابه للتابع <code>IO.write</code> | + | * التابع <code>[[Ruby/IO/binwrite|binwrite]]</code>: التابع <code>binwrite</code> مشابه للتابع <code>IO.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 في توثيق روبي الرسمي.] | ||
مراجعة 19:53، 12 نوفمبر 2018
يفتح التابع binread الملف، ثم يتموضع عند موضع الإزاحة offset (انظر فقرة البنية العامة) في حال إعطائه، ثم يُعيد length بايت (قيمته الافتراضية تساوي طول بقية الملف).
يضمن التابع binread أن يُغلق الملف قبل العودة.
وضع الفتح هو "rb:ASCII-8BIT".
البنية العامة
binread(name, [length [, offset]] )→ string
المعاملات
name
اسم الملف.
length
عدد صحيح يمثل الطول.
offset
عدد صحيح يمثل الإزاحة.
القيمة المُعادة
يُعيد التابع binread سلسلة نصية.
أمثلة
مثال على استخدام التابع 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: التابعbinwriteمشابه للتابعIO.write، ما عدا أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT.