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