الفرق بين المراجعتين ل"Ruby/IO/syswrite"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) ط (تدقيق) |
|||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
| − | يكتب التابع <code>syswrite</code> [[Ruby/String|السلسلة النصية]] | + | يكتب التابع <code>syswrite</code> [[Ruby/String|السلسلة النصية]] المُمرَّرة إليه في [[Ruby/IO|المجرى]] الذي استُدعي معه باستخدام كتابة منخفض المستوى (low-level write). |
| − | لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في [[Ruby/IO|المجرى]]، | + | لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في [[Ruby/IO|المجرى]]، وإلا ستحصل على نتائج غير متوقعة. |
يُطلق الاستثناء [[Ruby/SystemCallError|<code>SystemCallError</code>]] عند حدوث خطأ. | يُطلق الاستثناء [[Ruby/SystemCallError|<code>SystemCallError</code>]] عند حدوث خطأ. | ||
| سطر 12: | سطر 12: | ||
==المعاملات== | ==المعاملات== | ||
===<code>string</code>=== | ===<code>string</code>=== | ||
| − | [[Ruby/String|سلسلة نصية]] | + | [[Ruby/String|سلسلة نصية]] يراد كتابتها على المجرى. |
| − | ==القيمة | + | ==القيمة المعادة== |
| − | + | يعاد عدد صحيح يمثِّل عدد البايتات المكتوبة في المجرى. | |
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>syswrite</code>:<syntaxhighlight lang="ruby">f = File.new("out", "w") | مثال على استخدام التابع <code>syswrite</code>:<syntaxhighlight lang="ruby">f = File.new("out", "w") | ||
f.syswrite("ABCDEF") #=> 6</syntaxhighlight> | f.syswrite("ABCDEF") #=> 6</syntaxhighlight> | ||
| − | ==انظر | + | ==انظر أيضًا== |
| − | *التابع <code>[[Ruby/IO/sysread|sysread]]</code>: يقرأ | + | *التابع <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 قسم | + | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-syswrite قسم التابع syswrite في الصنف IO في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 12:21، 23 ديسمبر 2018
يكتب التابع 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: يكتب السلاسل النصية المُمرَّرة إليه في المجرى الذي استدعي معه.