التابع 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: يكتب السلاسل النصية المُمرَّرة إليه في المجرى الذي استدعي معه. 

مصادر