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

من موسوعة حسوب
< Ruby‏ | IO
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>IO.sysseek‎</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby...'
 
لا ملخص تعديل
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
[[تصنيف: Ruby IO]]
يسعى التابع <code>sysseek</code> إلى التموضع عند الإزاحة المعطاة <code>offset</code> (انظر فقرة البنية العامة) وفقا لقيمة <code>whence</code> (انظر <code>IO#seek</code> للتعرف على القيم الممكنة للوسيط <code>whence</code>). يُعيد الإزاحة الجديدة للملف.
يسعى التابع <code>sysseek</code> إلى التموضع عند الإزاحة المعطاة <code>offset</code> (انظر فقرة البنية العامة) وفقا لقيمة <code>whence</code> (انظر صفحة <code>[[Ruby/IO/seek|seek]]</code> للتعرف على القيم الممكنة للوسيط <code>whence</code>)، ثم يُعيد الإزاحة الجديدة للملف.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">sysseek(offset, whence=IO::SEEK_SET)→ integer‎</syntaxhighlight>
<syntaxhighlight lang="ruby">sysseek(offset, whence=IO::SEEK_SET)→ integer‎</syntaxhighlight>
سطر 10: سطر 10:
عدد صحيح يمثل الإزاحة
عدد صحيح يمثل الإزاحة
===<code>whence‎</code>===
===<code>whence‎</code>===
راية تمثل خيارات الإزاحة.
==القيمة المُعادة==
==القيمة المُعادة==
يُعيد التابع <code>sysseek</code> عددا صحيحا يمثل الإزاحة الجديدة.
==أمثلة==
==أمثلة==
مثال على استخدام التابع <code>sysseek‎</code>:
مثال على استخدام التابع <code>sysseek‎</code>:
سطر 17: سطر 21:
f.sysread(10)                  #=> "And so on."‎</syntaxhighlight>
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>، أو قد تحصل على نتائج غير متوقعة.
* التابع <nowiki/>[[Ruby/IO/seek|<code></code>]]<code>[[Ruby/IO/syswrite|seek]]</code>: يسعى إلى التموضع عند الإزاحة المعطاة في مجرى د/خ وفقا لقيمة <code>whence</code>
* التابع <code>[[Ruby/IO/syswrite|syswrite]]</code>: يكتب  [[Ruby/String|السلسلة النصية]] المعطاة في [[Ruby/IO|مجرى د/خ]] الذي استُدعي معه <code>ios</code> باستخدام كتابة منخفض المستوى (low-level write). ثم يعيد عدد البايتات المكتوبة. لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في [[Ruby/IO|مجرى د/خ]] <code>ios</code>، أو قد تحصل على نتائج غير متوقعة. يُطلق استثناء <code>SystemCallError</code> عند حدوث خطأ.
==مصادر==
==مصادر==
*[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‎ في توثيق روبي الرسمي.]

مراجعة 20:48، 13 نوفمبر 2018

يسعى التابع sysseek إلى التموضع عند الإزاحة المعطاة offset (انظر فقرة البنية العامة) وفقا لقيمة whence (انظر صفحة seek للتعرف على القيم الممكنة للوسيط whence)، ثم يُعيد الإزاحة الجديدة للملف.

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

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

المعاملات

offset‎

عدد صحيح يمثل الإزاحة

whence‎

راية تمثل خيارات الإزاحة.

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

يُعيد التابع sysseek عددا صحيحا يمثل الإزاحة الجديدة.

أمثلة

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

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

انظر أيضا

  • التابع seek: يسعى إلى التموضع عند الإزاحة المعطاة في مجرى د/خ وفقا لقيمة whence

مصادر