عرض مصدر Ruby/IO/syswrite

<noinclude>{{DISPLAYTITLE: التابع <code>IO.syswrite‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby IO]]
يكتب التابع <code>syswrite</code> [[Ruby/String|السلسلة النصية]] المُمرَّرة إليه في [[Ruby/IO|المجرى]] الذي استُدعي معه باستخدام كتابة منخفض المستوى (low-level write). 

لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في [[Ruby/IO|المجرى]]، وإلا ستحصل على نتائج غير متوقعة.

يُطلق الاستثناء [[Ruby/SystemCallError|<code>SystemCallError</code>]] عند حدوث خطأ.
==البنية العامة==
<syntaxhighlight lang="ruby">syswrite(string)→ integer‎</syntaxhighlight>
==المعاملات==
===<code>string‎</code>===
[[Ruby/String|سلسلة نصية]] يراد كتابتها على المجرى.
==القيمة المعادة==
يعاد عدد صحيح يمثِّل عدد البايتات المكتوبة في المجرى.

==أمثلة==
مثال على استخدام التابع <code>syswrite‎</code>:<syntaxhighlight lang="ruby">f = File.new("out", "w")
f.syswrite("ABCDEF")   #=> 6‎</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Ruby/IO/sysread|sysread]]</code>: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها ك[[Ruby/String|سلسلة نصية]].
*التابع [[Ruby/IO/sysseek|<code>sysseek</code>]]: يحرِّك مؤشر <nowiki/>[[Ruby/IO|المجرى]] الذي استدعي معه إلى موضع محدَّد.
*التابع [[Ruby/IO/write-i|<code>write</code>]]: يكتب [[Ruby/String|السلاسل النصية]] المُمرَّرة إليه في [[Ruby/IO|المجرى]] الذي استدعي معه. 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-syswrite قسم التابع syswrite‎ في الصنف IO‎ في توثيق روبي الرسمي.]