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