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

المراجعة الحالية بتاريخ 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)، ثم يُعيدها كسلسلة نصية.

مصادر

قسم التابع sysseek‎ في الصنف IO‎ في توثيق روبي الرسمي.

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