التابع IO.sysseek‎ في روبي

يحرِّك التابع 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."‎

انظر أيضًا

• التابع rewind: يعيد مؤشر المجرى الذي استُدعي معه إلى موضع بداية الإدخال.

• التابع seek: يحرِّك مؤشر المجرى الذي استدعي معه إلى موضع محدَّد.
• التابع sysread: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها كسلسلة نصية.

مصادر

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