الفرق بين المراجعتين لصفحة: «Ruby/IO/write-i»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط تدقيق |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
يكتب التابع <code>write</code> [[Ruby/String|السلاسل النصية]] | يكتب التابع <code>write</code> [[Ruby/String|السلاسل النصية]] المُمرَّرة إليه في [[Ruby/IO|المجرى]] الذي استدعي معه. يجب أن يكون المجرى مفتوحا في وضعية للكتابة. | ||
سيتم تحويل الوسائط غير النصية إلى [[Ruby/String|سلسلة نصية]] باستخدام التابع <code>to_s</code>. | |||
<code> | |||
==البنية العامة== | ==البنية العامة== | ||
<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>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/write_nonblock|write_nonblock]]</code>: يكتب | * التابع [[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 قسم | *[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().
- التابع
write_nonblock: يكتب السلسلة النصية المُمرَّرة إليه في المجرى الذي استُدعي معه باستخدام استدعاء النظامwrite(2)بعد تعيين قيمة الرايةO_NONBLOCKالخاصة بواصف الملف (file descriptor) الأساسي.