الفرق بين المراجعتين لصفحة: «Ruby/ARGF/getc»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby ARGF]] | [[تصنيف: Ruby ARGF]] | ||
يجلب التابع <code>getc</code> المحرف التالي من المجرى | يجلب التابع <code>getc</code> المحرف التالي من المجرى <code>ARGF</code>. | ||
يعامل المجرى | يعامل المجرى <code>ARGF</code> الملفات المُمرَّرة في سطر الأوامر كما لو كانت ملفًا واحدًا يتألَّف من جميع تلك الملفات؛ أي يتعاقب بعضها خلف بعض. بناءً على ذلك، يؤدي استدعاء التابع <code>getc</code> مرة أخرى بعد جلب المحرف الأخير من الملف الأول مثلًا إلى جلب المحرف الأول من الملف الثاني، وهلم جرًّا. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> getc → String or nil | <syntaxhighlight lang="ruby">getc → String or nil | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد سلسلة نصية تحوي المحرف التالي الذي يُقرَأ من المجرى | تعاد سلسلة نصية تحوي المحرف التالي الذي يُقرَأ من المجرى <code>ARGF</code>، أو تعاد القيمة <code>nil</code> عند الوصول إلى نهاية المجرى. | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استخدام التابع <code>getc</code>: | مثالٌ على استخدام التابع <code>getc</code>: | ||
<syntaxhighlight lang="ruby"> $ echo "foo" > file | <syntaxhighlight lang="ruby">$ echo "foo" > file | ||
$ ruby argf.rb file | $ ruby argf.rb file | ||
| سطر 24: | سطر 24: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/ARGF/getbyte | <code>getbyte</code>]]: يجلب بايتًا واحدًا (8 بتّات) من المجرى | * التابع<nowiki/>[[Ruby/ARGF/getbyte | <code>getbyte</code>]]: يجلب بايتًا واحدًا (8 بتّات) من المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى | * التابع<nowiki/>[[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/putc | <code>putc</code>]]: يكتب محرفًا واحدًا على المجرى <code>ios</code>. | * التابع<nowiki/>[[Ruby/ARGF/putc | <code>putc</code>]]: يكتب محرفًا واحدًا على المجرى <code>ios</code>. | ||
* التابع [[Ruby/ARGF/readbyte | <code>readbyte</code>]]: يقرأ البايت التالي من المجرى | * التابع<nowiki/>[[Ruby/ARGF/readbyte | <code>readbyte</code>]]: يقرأ البايت التالي من المجرى <code>ARGF</code> ثمَّ يعيده على شكل عدد صحيح (Integer). | ||
* التابع [[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى | * التابع<nowiki/>[[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى <code>ARGF</code> ثم يعيده على شكل سلسلة نصية. | ||
==مصادر== | ==مصادر== | ||
* [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-getc قسم التابع getc في الصنف ARGF في توثيق روبي الرسمي.] | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-getc قسم التابع getc في الصنف ARGF في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 12:35، 3 أكتوبر 2018
يجلب التابع getc المحرف التالي من المجرى ARGF.
يعامل المجرى ARGF الملفات المُمرَّرة في سطر الأوامر كما لو كانت ملفًا واحدًا يتألَّف من جميع تلك الملفات؛ أي يتعاقب بعضها خلف بعض. بناءً على ذلك، يؤدي استدعاء التابع getc مرة أخرى بعد جلب المحرف الأخير من الملف الأول مثلًا إلى جلب المحرف الأول من الملف الثاني، وهلم جرًّا.
البنية العامة
getc → String or nil
القيم المعادة
تعاد سلسلة نصية تحوي المحرف التالي الذي يُقرَأ من المجرى ARGF، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى.
أمثلة
مثالٌ على استخدام التابع getc:
$ echo "foo" > file
$ ruby argf.rb file
ARGF.getc #=> "f"
ARGF.getc #=> "o"
ARGF.getc #=> "o"
ARGF.getc #=> "\n"
ARGF.getc #=> nil
ARGF.getc #=> nil
انظر أيضًا
- التابع
getbyte: يجلب بايتًا واحدًا (8 بتّات) من المجرىARGF. - التابع
gets: يجلب السطر التالي من الملف الحالي في المجرىARGF. - التابع
putc: يكتب محرفًا واحدًا على المجرىios. - التابع
readbyte: يقرأ البايت التالي من المجرىARGFثمَّ يعيده على شكل عدد صحيح (Integer). - التابع
readchar: يقرأ المحرف التالي من المجرىARGFثم يعيده على شكل سلسلة نصية.