الفرق بين المراجعتين ل"Ruby/IO/write-i"

من موسوعة حسوب
< Ruby‏ | IO
اذهب إلى التنقل اذهب إلى البحث
ط (تدقيق)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby IO]]
 
[[تصنيف: Ruby IO]]
يكتب التابع <code>write</code> [[Ruby/String|السلاسل النصية]] المعطاة في [[Ruby/IO|مجرى د/خ]] <code>ios</code>. يجب أن يكون المجرى مفتوحا في وضعية للكتابة. سيتم تحويل الوسائط غير النصية إلى [[Ruby/String|سلسلة نصية]] باستخدام <code>to_s</code>. يُعيد التابع <code>write</code> عدد البايتات المكتوبة في الإجمال.
+
يكتب التابع <code>write</code> [[Ruby/String|السلاسل النصية]] المُمرَّرة إليه في [[Ruby/IO|المجرى]] الذي استدعي معه. يجب أن يكون المجرى مفتوحا في وضعية للكتابة.  
  
 
+
سيتم تحويل الوسائط غير النصية إلى [[Ruby/String|سلسلة نصية]] باستخدام التابع <code>to_s</code>.
 
 
<code>produces:</code>
 
 
 
<syntaxhighlight lang="ruby">This is a test
 
That was 15 bytes of data‎</syntaxhighlight>
 
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">write(string, ...) → integer‎</syntaxhighlight>
 
<syntaxhighlight lang="ruby">write(string, ...) → integer‎</syntaxhighlight>
 
==المعاملات==
 
==المعاملات==
 
===<code>string‎</code>===
 
===<code>string‎</code>===
[[Ruby/String|سلسلة نصية]]
+
[[Ruby/String|سلسلة نصية]] يراد كتابتها في المجرى المعطى.
===<code>...‎</code>===
+
==القيمة المعادة==
==القيمة المُعادة==
+
تعاد عدد البايتات المكتوبة في المجرى.
 +
 
 
==أمثلة==
 
==أمثلة==
 
مثال على استخدام التابع <code>write‎</code>:
 
مثال على استخدام التابع <code>write‎</code>:
 
<syntaxhighlight lang="ruby">count = $stdout.write("This is", " a test\n")
 
<syntaxhighlight lang="ruby">count = $stdout.write("This is", " a test\n")
puts "That was #{count} bytes of data"‎</syntaxhighlight>
+
puts "That was #{count} bytes of data"‎</syntaxhighlight>الناتج:<syntaxhighlight lang="text">This is a test
==انظر أيضا==
+
That was 15 bytes of data‎</syntaxhighlight>
* التابع <code>[[Ruby/IO/ungetc|ungetc]]</code>: يدفع  حرفا واحدا (المُمرر كوسيط) في [[Ruby/IO|مجرى د/خ]] الذي استُدعي معه <code>ios</code>، بحيث ستعيدها القراءة التالية من المخزن المؤقت (buffer). لا يمكنك أن تدفع إلا حرف واحد فقط قبل عملية القراءة اللاحقة (أي، لن تتمكن من قراءة إلا آخر حرف من الحروف التي دفتعها). ليس له أي تأثير مع القراءات غير التخزينية (unbuffered reads) (مثل <code>IO#sysread</code>).
+
==انظر أيضًا==
* التابع <code>[[Ruby/IO/write_nonblock|write_nonblock]]</code>: يكتب [[Ruby/String|السلسلة النصية]] المعطاة في <code>ios</code> باستخدام استدعاء النظام write(2)‎ بعد تعيين O_NONBLOCK لواصف الملف (file descriptor) الأساسي.
+
* التابع [[Ruby/IO/pwrite|<code>pwrite</code>]]: يكتب [[Ruby/String|السلسلة النصية]] المُمرَّرة إليه في موضع محدَّد من [[Ruby/IO|المجرى]] الذي استُدعي معه باستخدام استدعاء دالة النظام <code>pwrite()‎</code>.  
 +
 
 +
* التابع [[Ruby/IO/read-i|<code>read</code>]]: يقرأ عددًا محدَّدًا من البايتات من [[Ruby/IO|المجرى]] الذي استدعي معه.
 +
 
 +
* التابع <code>[[Ruby/IO/write_nonblock|write_nonblock]]</code>: يكتب [[Ruby/String|السلسلة النصية]] المُمرَّرة إليه في [[Ruby/IO|المجرى]] الذي استُدعي معه باستخدام استدعاء النظام <code>write(2)‎</code> بعد تعيين قيمة الراية <code>O_NONBLOCK</code> الخاصة بواصف الملف (file descriptor) الأساسي.
 
==مصادر==
 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-write قسم التابع write‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-write قسم التابع write‎ في الصنف IO‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 12:28، 23 ديسمبر 2018

يكتب التابع write السلاسل النصية المُمرَّرة إليه في المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحا في وضعية للكتابة.

سيتم تحويل الوسائط غير النصية إلى سلسلة نصية باستخدام التابع to_s.

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

write(string, ...)  integer

المعاملات

string‎

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

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

تعاد عدد البايتات المكتوبة في المجرى.

أمثلة

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

count = $stdout.write("This is", " a test\n")
puts "That was #{count} bytes of data"

الناتج:

This is a test
That was 15 bytes of data‎

انظر أيضًا

  • التابع pwrite: يكتب السلسلة النصية المُمرَّرة إليه في موضع محدَّد من المجرى الذي استُدعي معه باستخدام استدعاء دالة النظام pwrite()‎.  
  • التابع read: يقرأ عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه.
  • التابع write_nonblock: يكتب السلسلة النصية المُمرَّرة إليه في المجرى الذي استُدعي معه باستخدام استدعاء النظام write(2)‎ بعد تعيين قيمة الراية O_NONBLOCK الخاصة بواصف الملف (file descriptor) الأساسي.

مصادر