الفرق بين المراجعتين لصفحة: «Ruby/ARGF/seek»

مراجعة 18:31، 10 سبتمبر 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.

مصادر

قسم التابع seek في صفحة الصنف ARGF في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby ARGF]]
-يحرِّك التابع <code>seek</code> المؤشِّر الحالي في المجرى [[Ruby/ARGF/ARGF | <code>ARGF</code>]] إلى موقع محدد.
+يحرِّك التابع <code>seek</code> المؤشِّر الحالي في المجرى  <code>ARGF</code> إلى موقع محدد.
 ==البنية العامة==
 <syntaxhighlight lang="ruby"> seek(amount, whence=IO::SEEK_SET) → 0
   </syntaxhighlight>
 ==المعاملات==
-<code>amount</code>
+=== <code>amount</code> ===
 قيمة إزاحة موقع المؤشِّر بالبايت.
-إن أردت تحريك المؤشِّر انطلاقًا من نهاية الملف، فمرِّر قيمة سالبة للمعامل <code>amount</code> ثمَّ حدِّد القيمة ‎:<code>END</code> أو <code>IO</code>::<code>SEEK_END</code> للمعامل <code>whence</code>.
+إن أردت تحريك المؤشِّر انطلاقًا من نهاية الملف، فمرِّر قيمة سالبة للمعامل <code>amount</code> ثمَّ حدِّد القيمة ‎<code>:END</code> أو <code>IO</code>::<code>SEEK_END</code> للمعامل <code>whence</code>.
-<code>whence</code>
+=== <code>whence</code> ===
 قيمة هذا المعامل هي إحدى القيم التالية:
-‎:<code>SET</code> أو <code>IO</code>::<code>SEEK_SET</code>: تغيير موقع المؤشِّر إلى قيمة المعامل <code>amount</code> المعطاة بالبايت انطلاقًا من البداية.
+‎<code>:SET</code> أو <code>IO::SEEK_SET</code>: تغيير موقع المؤشِّر إلى قيمة المعامل <code>amount</code> المعطاة بالبايت انطلاقًا من البداية.
-‎:<code>CUR</code> أو <code>IO</code>::<code>SEEK_CUR</code>: تغيير موقع المؤشِّر إلى قيمة المعامل <code>amount</code> المعطاة بالبايت مضافًا إليها قيمة موقع المؤشِّر الحالي.
-‎:<code>END</code> أو <code>IO</code>::<code>SEEK_END</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>:
@@ سطر 25: / سطر 30: @@
   </syntaxhighlight>
 ==انظر أيضًا==
-* التابع [[Ruby/ARGF/pos | <code>pos</code>]]: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى [[Ruby/ARGF/ARGF | <code>ARGF</code>]].
+* التابع [[Ruby/ARGF/pos | <code>pos</code>]]: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى  <code>ARGF</code>.
-* التابع [[Ruby/ARGF/pos | <code>pos</code>]]: ينقل عند استدعائه بالشكل [[Ruby/ARGF/pos | <code>pos</code>]] = <code>position</code> المؤشِّر إلى المكان <code>position</code> (المعطى بالبايت) في المجرى [[Ruby/ARGF/ARGF | <code>ARGF</code>]].
+* التابع   [[Ruby/ARGF/pos-3D|<code>= pos</code>]]: ينقل عند استدعائه بالشكل  <code>pos =</code> <code>position</code> المؤشِّر إلى المكان <code>position</code> (المعطى بالبايت) في المجرى  <code>ARGF</code>.
-* التابع [[Ruby/ARGF/fileno | <code>fileno</code>]]: يعيد عددًا صحيحًا يمثل واصف الملف العددي (<code>numeric</code> [[Ruby/ARGF/file | <code>file</code>]] <code>descriptor</code>) للملف الحالي.
+* التابع [[Ruby/ARGF/fileno | <code>fileno</code>]]: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric  file descriptor) للملف الحالي.
-* التابع [[Ruby/ARGF/lineno | <code>lineno</code>]]: يجلب رقم السطر الحالي للمجرى [[Ruby/ARGF/ARGF | <code>ARGF</code>]] ككُل.
+* التابع [[Ruby/ARGF/lineno | <code>lineno</code>]]: يجلب رقم السطر الحالي للمجرى  <code>ARGF</code> ككُل.
-* التابع [[Ruby/ARGF/rewind | <code>rewind</code>]]: يُرجِع المؤشر إلى بداية الملف الحالي عند بداية المدخلات (<code>input</code>) ويعيد تعيين رقم السطر [[Ruby/ARGF/ARGF | <code>ARGF</code>]].[[Ruby/ARGF/lineno | <code>lineno</code>]] إلى القيمة 0.
+* التابع [[Ruby/ARGF/rewind | <code>rewind</code>]]: يُرجِع المؤشر إلى بداية الملف الحالي عند بداية المدخلات (<code>input</code>) ويعيد تعيين رقم السطر  <code>ARGF.[[Ruby/ARGF/lineno |lineno]]</code> إلى القيمة <code>0</code>.
-* التابع [[Ruby/ARGF/tell | <code>tell</code>]]: يعيد موضع المؤشِّر الحالي في الملف الحالي في [[Ruby/ARGF/ARGF | <code>ARGF</code>]].
+* التابع [[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 في توثيق روبي الرسمي.]
-[a]كيف يمكننا تعديل المثال ليتوافق مع المجرى ARGF؟ احضرته من التابع IO.seek، إذ لا يوجد مثال في التوثيق لهذا التابع.
-+abdallatif.ey@gmail.com
-_تم التعيين إلى Abd Allatif_