التابع IO.syswrite‎ في روبي

من موسوعة حسوب
< Ruby‏ | IO

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

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

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

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

syswrite(string)→ integer‎

المعاملات

string‎

سلسلة نصية يراد كتابتها على المجرى.

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

يعاد عدد صحيح يمثِّل عدد البايتات المكتوبة في المجرى.

أمثلة

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

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

انظر أيضًا

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

مصادر