التابع ARGF.seek في روبي

يحرِّك التابع seek المؤشِّر الحالي في المجرى ARGF إلى موقع محدد.

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

 seek(amount, whence=IO::SEEK_SET) → 0

المعاملات

amount قيمة إزاحة موقع المؤشِّر بالبايت. إن أردت تحريك المؤشِّر انطلاقًا من نهاية الملف، فمرِّر قيمة سالبة للمعامل amount ثمَّ حدِّد القيمة ‎:END أو IO::SEEK_END للمعامل whence. whence قيمة هذا المعامل هي إحدى القيم التالية: ‎:SET أو IO::SEEK_SET: تغيير موقع المؤشِّر إلى قيمة المعامل amount المعطاة بالبايت انطلاقًا من البداية. ‎:CUR أو IO::SEEK_CUR: تغيير موقع المؤشِّر إلى قيمة المعامل amount المعطاة بالبايت مضافًا إليها قيمة موقع المؤشِّر الحالي. ‎:END أو IO::SEEK_END: تغيير موقع المؤشِّر إلى قيمة موقع نهاية الملف مضافًا إليها قيمة المعامل amount المعطاة بالبايت.

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

يعاد العدد 0 عند نجاح العملية.

أمثلة

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

 f = File.new("testfile")
f.seek(-13, IO::SEEK_END)   #=> 0
f.readline                  #=> "And so on...\n"[a]

انظر أيضًا

• التابع pos: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى ARGF.
• التابع pos: ينقل عند استدعائه بالشكل pos = position المؤشِّر إلى المكان position (المعطى بالبايت) في المجرى ARGF.
• التابع fileno: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي.
• التابع lineno: يجلب رقم السطر الحالي للمجرى ARGF ككُل.
• التابع rewind: يُرجِع المؤشر إلى بداية الملف الحالي عند بداية المدخلات (input) ويعيد تعيين رقم السطر ARGF. lineno إلى القيمة 0.
• التابع tell: يعيد موضع المؤشِّر الحالي في الملف الحالي في ARGF.

مصادر

• قسم التابع seek في صفحة الصنف ARGF في توثيق روبي الرسمي.

[a]كيف يمكننا تعديل المثال ليتوافق مع المجرى ARGF؟ احضرته من التابع IO.seek، إذ لا يوجد مثال في التوثيق لهذا التابع. +abdallatif.ey@gmail.com _تم التعيين إلى Abd Allatif_