الفرق بين المراجعتين ل"Ruby/ARGF/seek"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>ARGF.seek</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby ARGF...') |
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة وتدقيق.) |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 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> | ||
==المعاملات== | ==المعاملات== | ||
| − | <code>amount</code> | + | |
| + | === <code>amount</code> === | ||
قيمة إزاحة موقع المؤشِّر بالبايت. | قيمة إزاحة موقع المؤشِّر بالبايت. | ||
| − | إن أردت تحريك المؤشِّر انطلاقًا من نهاية الملف، فمرِّر قيمة سالبة للمعامل <code>amount</code> ثمَّ حدِّد القيمة | + | إن أردت تحريك المؤشِّر انطلاقًا من نهاية الملف، فمرِّر قيمة سالبة للمعامل <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>:CUR</code> أو <code>IO::SEEK_CUR</code>: تغيير موقع المؤشِّر إلى قيمة المعامل <code>amount</code> المعطاة بالبايت مضافًا إليها قيمة موقع المؤشِّر الحالي. | |
| − | | + | * <code>:END</code> أو <code>IO::SEEK_END</code>: تغيير موقع المؤشِّر إلى قيمة موقع نهاية الملف مضافًا إليها قيمة المعامل <code>amount</code> المعطاة بالبايت. |
| + | |||
==القيم المعادة== | ==القيم المعادة== | ||
| − | يعاد العدد 0 عند نجاح العملية. | + | يعاد العدد <code>0</code> عند نجاح العملية. |
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <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 | <code>pos</code>]]: ينقل عند استدعائه بالشكل | + | * التابع [[Ruby/ARGF/pos-3D|<code>pos</code>]]: ينقل عند استدعائه بالشكل <code>pos = position</code> المؤشِّر إلى المكان <code>position</code> (المعطى بالبايت) في المجرى <code>ARGF</code>. |
| − | * التابع [[Ruby/ARGF/fileno | <code>fileno</code>]]: يعيد عددًا صحيحًا يمثل واصف الملف العددي ( | + | * التابع<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>. |
==مصادر== | ==مصادر== | ||
| − | * قسم التابع 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.