التابع 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.