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

من موسوعة حسوب
< Ruby‏ | IO
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>IO.syswrite‎</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby...'
 
لا ملخص تعديل
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
[[تصنيف: Ruby IO]]
يكتب التابع <code>syswrite</code> [[Ruby/String|السلسلة النصية]] المعطاة في [[Ruby/IO|مجرى د/خ]] الذي استُدعي معه <code>ios</code> باستخدام كتابة منخفض المستوى (low-level write). ثم يعيد عدد البايتات المكتوبة. لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في [[Ruby/IO|مجرى د/خ]] <code>ios</code>، أو قد تحصل على نتائج غير متوقعة. يُطلق استثناء <code>SystemCallError</code> عند حدوث خطأ.
يكتب التابع <code>syswrite</code> [[Ruby/String|السلسلة النصية]] المعطاة في [[Ruby/IO|مجرى د/خ]] الذي استُدعي معه باستخدام كتابة منخفض المستوى (low-level write). ثم يعيد عدد البايتات المكتوبة. 
 
لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في [[Ruby/IO|المجرى]]، أو قد تحصل على نتائج غير متوقعة.
 
يُطلق الاستثناء [[Ruby/SystemCallError|<code>SystemCallError</code>]] عند حدوث خطأ.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">syswrite(string)→ integer‎</syntaxhighlight>
<syntaxhighlight lang="ruby">syswrite(string)→ integer‎</syntaxhighlight>
سطر 10: سطر 14:
[[Ruby/String|سلسلة نصية]]
[[Ruby/String|سلسلة نصية]]
==القيمة المُعادة==
==القيمة المُعادة==
يعيد التابع <code>syswrite</code> عدد البايتات المكتوبة.
==أمثلة==
==أمثلة==
مثال على استخدام التابع <code>syswrite‎</code>:
مثال على استخدام التابع <code>syswrite‎</code>:<syntaxhighlight lang="ruby">f = File.new("out", "w")
<syntaxhighlight lang="ruby">f = File.new("out", "w")
f.syswrite("ABCDEF")  #=> 6‎</syntaxhighlight>
f.syswrite("ABCDEF")  #=> 6‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضا==
* التابع <code>[[Ruby/IO/sysseek|sysseek]]</code>: يسعى  إلى التموضع عند الإزاحة المعطاة <code>offset</code> (انظر فقرة البنية العامة) وفقا لقيمة <code>whence</code> (انظر <code>IO#seek</code> للتعرف على القيم الممكنة للوسيط <code>whence</code>). يُعيد الإزاحة الجديدة للملف.
*التابع <code>[[Ruby/IO/sysread|sysread]]</code>: يقرأ  ‏<code>maxlen</code>  بايتًا باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها كسلسلة نصية.
* التابع <code>[[Ruby/IO/tell|tell]]</code>: يُعيد  الإزاحة الحالية (بالبايت) في [[Ruby/IO|مجرى د/خ]] <code>ios</code>.
==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-syswrite قسم  التابع syswrite‎ في الصنف IO‎ في توثيق روبي الرسمي.]
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-syswrite قسم  التابع syswrite‎ في الصنف IO‎ في توثيق روبي الرسمي.]

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

يكتب التابع syswrite السلسلة النصية المعطاة في مجرى د/خ الذي استُدعي معه باستخدام كتابة منخفض المستوى (low-level write). ثم يعيد عدد البايتات المكتوبة. 

لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في المجرى، أو قد تحصل على نتائج غير متوقعة.

يُطلق الاستثناء SystemCallError عند حدوث خطأ.

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

syswrite(string) integer

المعاملات

string‎

سلسلة نصية

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

يعيد التابع syswrite عدد البايتات المكتوبة.

أمثلة

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

f = File.new("out", "w")
f.syswrite("ABCDEF")   #=> 6‎

انظر أيضا

  • التابع sysread: يقرأ  ‏maxlen  بايتًا باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها كسلسلة نصية.

مصادر