الفرق بين المراجعتين لصفحة: «Ruby/IO/sysseek»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط تدقيق |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
يحرِّك <code>sysseek</code> مؤشر <nowiki/>[[Ruby/IO|المجرى]] الذي استدعي معه إلى موضع محدَّد. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">sysseek(offset, whence=IO::SEEK_SET)→ integer</syntaxhighlight> | <syntaxhighlight lang="ruby">sysseek(offset, whence=IO::SEEK_SET)→ integer</syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
===<code>offset</code>=== | ===<code>offset</code>=== | ||
عدد صحيح | عدد صحيح يحدِّد مقدار إزاحة المؤشر بدءًا من بداية الملف (القيمة الافتراضية للمعامل <code>whence</code>) أو من نهاية الملف أو من الموضع الحالي للموشر نفسه بحسب قيمة المعامل <code>whence</code>. | ||
===<code>whence</code>=== | ===<code>whence</code>=== | ||
راية | راية تحدد الموضع الذي سيزاح المؤشر بدءًا منه بالمقدار <code>amount</code>. اطلع على صفحة التابع <code>[[Ruby/IO/seek#whence.E2.80.8E|seek]]</code> للاطلاع على القيم التي يمكن أن يأخذها هذا المعامل. | ||
==القيمة | ==القيمة المعادة== | ||
يعاد [[Ruby/Integer|عدد صحيح]] يمثِّل موضع المؤشر الجديد بعد تحريكه إليه. | |||
==أمثلة== | ==أمثلة== | ||
| سطر 20: | سطر 20: | ||
f.sysseek(-13, IO::SEEK_END) #=> 53 | f.sysseek(-13, IO::SEEK_END) #=> 53 | ||
f.sysread(10) #=> "And so on."</syntaxhighlight> | f.sysread(10) #=> "And so on."</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <nowiki/>[[Ruby/IO/seek|<code></code>]]<code>[[Ruby/IO/syswrite|seek]]</code>: | * التابع [[Ruby/IO/rewind|<code>rewind</code>]]: يعيد مؤشر [[Ruby/IO|المجرى]] الذي استُدعي معه إلى موضع بداية الإدخال. | ||
* التابع <nowiki/>[[Ruby/IO/seek|<code></code>]]<code>[[Ruby/IO/syswrite|seek]]</code>: يحرِّك مؤشر [[Ruby/IO|المجرى]] الذي استدعي معه إلى موضع محدَّد. | |||
* التابع [[Ruby/IO/sysread|<code>sysread</code>]]: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها ك[[Ruby/String|سلسلة نصية]]. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-sysseek قسم | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-sysseek قسم التابع sysseek في الصنف IO في توثيق روبي الرسمي.] | ||
مراجعة 11:45، 23 ديسمبر 2018
يحرِّك sysseek مؤشر المجرى الذي استدعي معه إلى موضع محدَّد.
البنية العامة
sysseek(offset, whence=IO::SEEK_SET)→ integer
المعاملات
offset
عدد صحيح يحدِّد مقدار إزاحة المؤشر بدءًا من بداية الملف (القيمة الافتراضية للمعامل whence) أو من نهاية الملف أو من الموضع الحالي للموشر نفسه بحسب قيمة المعامل whence.
whence
راية تحدد الموضع الذي سيزاح المؤشر بدءًا منه بالمقدار amount. اطلع على صفحة التابع seek للاطلاع على القيم التي يمكن أن يأخذها هذا المعامل.
القيمة المعادة
يعاد عدد صحيح يمثِّل موضع المؤشر الجديد بعد تحريكه إليه.
أمثلة
مثال على استخدام التابع sysseek:
f = File.new("testfile")
f.sysseek(-13, IO::SEEK_END) #=> 53
f.sysread(10) #=> "And so on."
انظر أيضًا
- التابع
seek: يحرِّك مؤشر المجرى الذي استدعي معه إلى موضع محدَّد. - التابع
sysread: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها كسلسلة نصية.