الفرق بين المراجعتين لصفحة: «Ruby/ARGF/seek»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby ARGF]] | [[تصنيف: Ruby ARGF]] | ||
يحرِّك التابع <code>seek</code> المؤشِّر الحالي في المجرى | يحرِّك التابع <code>seek</code> المؤشِّر الحالي في المجرى <code>ARGF</code> إلى موقع محدد. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> seek(amount, whence=IO::SEEK_SET) → 0 | <syntaxhighlight lang="ruby">seek(amount, whence=IO::SEEK_SET) → 0 | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
| سطر 11: | سطر 11: | ||
=== <code>amount</code> === | === <code>amount</code> === | ||
قيمة إزاحة موقع المؤشِّر بالبايت. | قيمة إزاحة موقع المؤشِّر بالبايت. | ||
إن أردت تحريك المؤشِّر انطلاقًا من نهاية الملف، فمرِّر قيمة سالبة للمعامل <code>amount</code> ثمَّ حدِّد القيمة <code>:END</code> أو <code>IO | إن أردت تحريك المؤشِّر انطلاقًا من نهاية الملف، فمرِّر قيمة سالبة للمعامل <code>amount</code> ثمَّ حدِّد القيمة <code>:END</code> أو <code>IO::SEEK_END</code> للمعامل <code>whence</code>. | ||
=== <code>whence</code> === | === <code>whence</code> === | ||
قيمة هذا المعامل هي إحدى القيم التالية: | قيمة هذا المعامل هي إحدى القيم التالية: | ||
<code>:SET</code> أو <code>IO::SEEK_SET</code>: تغيير موقع المؤشِّر إلى قيمة المعامل <code>amount</code> المعطاة بالبايت انطلاقًا من البداية. | * <code>:SET</code> أو <code>IO::SEEK_SET</code>: تغيير موقع المؤشِّر إلى قيمة المعامل <code>amount</code> المعطاة بالبايت انطلاقًا من البداية. | ||
* <code>:CUR</code> أو <code>IO::SEEK_CUR</code>: تغيير موقع المؤشِّر إلى قيمة المعامل <code>amount</code> المعطاة بالبايت مضافًا إليها قيمة موقع المؤشِّر الحالي. | |||
<code>:CUR</code> أو <code>IO::SEEK_CUR</code>: تغيير موقع المؤشِّر إلى قيمة المعامل <code>amount</code> المعطاة بالبايت مضافًا إليها قيمة موقع المؤشِّر الحالي. | * <code>:END</code> أو <code>IO::SEEK_END</code>: تغيير موقع المؤشِّر إلى قيمة موقع نهاية الملف مضافًا إليها قيمة المعامل <code>amount</code> المعطاة بالبايت. | ||
<code>:END</code> أو <code>IO::SEEK_END</code>: تغيير موقع المؤشِّر إلى قيمة موقع نهاية الملف مضافًا إليها قيمة المعامل <code>amount</code> المعطاة بالبايت. | |||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 25: | سطر 23: | ||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>seek</code>: | مثال على استخدام التابع <code>seek</code>: | ||
<syntaxhighlight lang="ruby"> f = File.new("testfile") | <syntaxhighlight lang="ruby">f = File.new("testfile") | ||
f.seek(-13, IO::SEEK_END) #=> 0 | f.seek(-13, IO::SEEK_END) #=> 0 | ||
f.readline #=> "And so on...\n"[a] | f.readline #=> "And so on...\n"[a] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/ARGF/pos | <code>pos</code>]]: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى | * التابع<nowiki/>[[Ruby/ARGF/pos | <code>pos</code>]]: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى <code>ARGF</code>. | ||
* التابع | * التابع [[Ruby/ARGF/pos-3D|<code>pos</code>]]: ينقل عند استدعائه بالشكل <code>pos = position</code> المؤشِّر إلى المكان <code>position</code> (المعطى بالبايت) في المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/fileno | <code>fileno</code>]]: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. | * التابع<nowiki/>[[Ruby/ARGF/fileno | <code>fileno</code>]]: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. | ||
* التابع [[Ruby/ARGF/lineno | <code>lineno</code>]]: يجلب رقم السطر الحالي للمجرى | * التابع<nowiki/>[[Ruby/ARGF/lineno | <code>lineno</code>]]: يجلب رقم السطر الحالي للمجرى <code>ARGF</code> ككُل. | ||
* التابع [[Ruby/ARGF/rewind | <code>rewind</code>]]: يُرجِع المؤشر إلى بداية الملف الحالي عند بداية المدخلات ( | * التابع<nowiki/>[[Ruby/ARGF/rewind | <code>rewind</code>]]: يُرجِع المؤشر إلى بداية الملف الحالي عند بداية المدخلات (input) ويعيد تعيين رقم السطر <code>[[Ruby/ARGF/lineno |ARGF.lineno]]</code> إلى القيمة <code>0</code>. | ||
* التابع [[Ruby/ARGF/tell | <code>tell</code>]]: يعيد موضع المؤشِّر الحالي في الملف الحالي في | * التابع<nowiki/>[[Ruby/ARGF/tell | <code>tell</code>]]: يعيد موضع المؤشِّر الحالي في الملف الحالي في <code>ARGF</code>. | ||
==مصادر== | ==مصادر== | ||
* [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-seek قسم التابع seek في صفحة الصنف ARGF في توثيق روبي الرسمي.] | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-seek قسم التابع seek في صفحة الصنف ARGF في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 13:49، 3 أكتوبر 2018
يحرِّك التابع 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.