التابع 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 في توثيق روبي الرسمي.