الفرق بين المراجعتين ل"Ruby/IO/sysseek"

من موسوعة حسوب
< Ruby‏ | IO
اذهب إلى التنقل اذهب إلى البحث
 
(مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين)
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby IO]]
 
[[تصنيف: Ruby IO]]
يسعى التابع <code>sysseek</code> إلى التموضع عند الإزاحة المعطاة <code>offset</code> (انظر فقرة البنية العامة) وفقا لقيمة <code>whence</code> (انظر صفحة <code>[[Ruby/IO/seek|seek]]</code> للتعرف على القيم الممكنة للوسيط <code>whence</code>)، ثم يُعيد الإزاحة الجديدة للملف.
+
يحرِّك التابع <code>sysseek</code> مؤشر <nowiki/>[[Ruby/IO|المجرى]] الذي استدعي معه إلى موضع محدَّد.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">sysseek(offset, whence=IO::SEEK_SET)→ integer‎</syntaxhighlight>
 
<syntaxhighlight lang="ruby">sysseek(offset, whence=IO::SEEK_SET)→ integer‎</syntaxhighlight>
 
==المعاملات==
 
==المعاملات==
 
===<code>offset‎</code>===
 
===<code>offset‎</code>===
عدد صحيح يمثل الإزاحة
+
عدد صحيح يحدِّد مقدار إزاحة المؤشر بدءًا من بداية الملف (القيمة الافتراضية للمعامل <code>whence‎</code>) أو من نهاية الملف أو من الموضع الحالي للموشر نفسه بحسب قيمة المعامل <code>whence‎</code>.
 
===<code>whence‎</code>===
 
===<code>whence‎</code>===
راية تمثل خيارات الإزاحة.
+
راية تحدد الموضع الذي سيزاح المؤشر بدءًا منه بالمقدار <code>amount</code>. اطلع على صفحة التابع <code>[[Ruby/IO/seek#whence.E2.80.8E|seek]]</code> للاطلاع على القيم التي يمكن أن يأخذها هذا المعامل.
  
==القيمة المُعادة==
+
==القيمة المعادة==
يُعيد التابع <code>sysseek</code> عددا صحيحا يمثل الإزاحة الجديدة.
+
يعاد [[Ruby/Integer|عدد صحيح]] يمثِّل موضع المؤشر الجديد بعد تحريكه إليه.
  
 
==أمثلة==
 
==أمثلة==
سطر 20: سطر 20:
 
f.sysseek(-13, IO::SEEK_END)  #=> 53
 
f.sysseek(-13, IO::SEEK_END)  #=> 53
 
f.sysread(10)                  #=> "And so on."‎</syntaxhighlight>
 
f.sysread(10)                  #=> "And so on."‎</syntaxhighlight>
==انظر أيضا==
+
==انظر أيضًا==
* التابع <nowiki/>[[Ruby/IO/seek|<code></code>]]<code>[[Ruby/IO/syswrite|seek]]</code>: يسعى إلى التموضع عند الإزاحة المعطاة في مجرى د/خ وفقا لقيمة <code>whence</code>
+
* التابع [[Ruby/IO/rewind|<code>rewind</code>]]: يعيد مؤشر [[Ruby/IO|المجرى]] الذي استُدعي معه إلى موضع بداية الإدخال.
 +
 
 +
* التابع [[Ruby/IO/syswrite|<code>seek</code>]]<nowiki/>[[Ruby/IO/seek|<code></code>]]: يحرِّك مؤشر [[Ruby/IO|المجرى]] الذي استدعي معه إلى موضع محدَّد.
 +
* التابع [[Ruby/IO/sysread|<code>sysread</code>]]: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها ك[[Ruby/String|سلسلة نصية]].
 
==مصادر==
 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-sysseek قسم التابع sysseek‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-sysseek قسم التابع sysseek‎ في الصنف IO‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 11:47، 23 ديسمبر 2018

يحرِّك التابع sysseek مؤشر المجرى الذي استدعي معه إلى موضع محدَّد.

البنية العامة

sysseek(offset, whence=IO::SEEK_SET) integer

المعاملات

offset‎

عدد صحيح يحدِّد مقدار إزاحة المؤشر بدءًا من بداية الملف (القيمة الافتراضية للمعامل whence‎) أو من نهاية الملف أو من الموضع الحالي للموشر نفسه بحسب قيمة المعامل whence‎.

whence‎

راية تحدد الموضع الذي سيزاح المؤشر بدءًا منه بالمقدار amount. اطلع على صفحة التابع seek للاطلاع على القيم التي يمكن أن يأخذها هذا المعامل.

القيمة المعادة

يعاد عدد صحيح يمثِّل موضع المؤشر الجديد بعد تحريكه إليه.

أمثلة

مثال على استخدام التابع sysseek‎:

f = File.new("testfile")
f.sysseek(-13, IO::SEEK_END)   #=> 53
f.sysread(10)                  #=> "And so on."‎

انظر أيضًا

  • التابع rewind: يعيد مؤشر المجرى الذي استُدعي معه إلى موضع بداية الإدخال.
  • التابع seek: يحرِّك مؤشر المجرى الذي استدعي معه إلى موضع محدَّد.
  • التابع sysread: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها كسلسلة نصية.

مصادر