الفرق بين المراجعتين لصفحة: «Ruby/IO/syswrite»

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

مصادر

قسم التابع syswrite‎ في الصنف IO‎ في توثيق روبي الرسمي.

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