الفرق بين المراجعتين لصفحة: «Ruby/ARGF/file»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 5: | سطر 5: | ||
يعيد التابع <code>file</code> الملف الحالي على شكل كائن من النوع <code>IO</code> أو <code>File</code>. | يعيد التابع <code>file</code> الملف الحالي على شكل كائن من النوع <code>IO</code> أو <code>File</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> file → IO or File object | <syntaxhighlight lang="ruby">file → IO or File object | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
يعاد كائن من النوع <code>IO</code> أو <code>File</code> يمثل الملف الحالي، أو القيمة | يعاد كائن من النوع <code>IO</code> أو <code>File</code> يمثل الملف الحالي، أو القيمة <code>$stdin</code> إن كان الملف الحالي هو مجرى الدخل القياسي (STDIN). | ||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>file</code>: | مثال على استخدام التابع <code>file</code>: | ||
<syntaxhighlight lang="ruby"> $ echo "foo" > foo | <syntaxhighlight lang="ruby">$ echo "foo" > foo | ||
$ echo "bar" > bar | $ echo "bar" > bar | ||
| سطر 21: | سطر 21: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/ARGF/close | <code>close</code>]]: يغلق الملف الحالي ويتخطاه إلى الملف التالي في <code>ARGV</code>. | * التابع<nowiki/>[[Ruby/ARGF/close | <code>close</code>]]: يغلق الملف الحالي ويتخطاه إلى الملف التالي في <code>ARGV</code>. | ||
* التابع [[Ruby/ARGF/eof | <code>eof?</code>]]: يتحقق إذا بلغ الملف الحالي نهايته في | * التابع<nowiki/>[[Ruby/ARGF/eof | <code>eof?</code>]]: يتحقق إذا بلغ الملف الحالي نهايته في <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/filename | <code>filename</code>]]: يعيد اسم الملف الحالي. | * التابع<nowiki/>[[Ruby/ARGF/filename | <code>filename</code>]]: يعيد اسم الملف الحالي. | ||
* التابع [[Ruby/ARGF/fileno | <code>fileno</code>]]: يعيد عددًا صحيحًا يمثل واصف الملف العددي ( | * التابع<nowiki/>[[Ruby/ARGF/fileno | <code>fileno</code>]]: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. | ||
* التابع [[Ruby/ARGF/inplace_mode | <code>inplace_mode</code>]]: يعيد امتداد الملف المضاف إلى أسماء الملفات المُعدَّلة وفق وضع التعديل الموضعي ( | * التابع<nowiki/>[[Ruby/ARGF/inplace_mode | <code>inplace_mode</code>]]: يعيد امتداد الملف المضاف إلى أسماء الملفات المُعدَّلة وفق وضع التعديل الموضعي (in-place edit mode). | ||
* التابع [[Ruby/ARGF/lineno | <code>lineno</code>]]: يجلب رقم السطر الحالي للمجرى | * التابع<nowiki/>[[Ruby/ARGF/lineno | <code>lineno</code>]]: يجلب رقم السطر الحالي للمجرى <code>ARGF</code> ككُل. | ||
* التابع [[Ruby/ARGF/pos | <code>pos</code>]]: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى | * التابع<nowiki/>[[Ruby/ARGF/pos | <code>pos</code>]]: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/skip | <code>skip</code>]]: يتخطى الملف الحالي إلى الملف التالي ويجعله هو الملفَّ الحالي في المجرى | * التابع<nowiki/>[[Ruby/ARGF/skip | <code>skip</code>]]: يتخطى الملف الحالي إلى الملف التالي ويجعله هو الملفَّ الحالي في المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/to_io | <code>to_io</code>]]: يعيد الملف الحالي على شكل كائن من النوع <code>IO</code>. | * التابع<nowiki/>[[Ruby/ARGF/to_io | <code>to_io</code>]]: يعيد الملف الحالي على شكل كائن من النوع <code>IO</code>. | ||
* التابع [[Ruby/ARGF/to_write_io | <code>to_write_io</code>]]: يعيد نسخةً من الصنف <code>IO</code> مرتبطةً بالمجرى | * التابع<nowiki/>[[Ruby/ARGF/to_write_io | <code>to_write_io</code>]]: يعيد نسخةً من الصنف <code>IO</code> مرتبطةً بالمجرى <code>ARGF</code> للكتابة عليها في حال كان الوضع <code>inplace</code> مفعَّلًا. | ||
==مصادر== | ==مصادر== | ||
* [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-file قسم التابع file في الصنف ARGF في توثيق روبي الرسمي.] | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-file قسم التابع file في الصنف ARGF في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 12:31، 3 أكتوبر 2018
يعيد التابع file الملف الحالي على شكل كائن من النوع IO أو File.
البنية العامة
file → IO or File object
القيم المعادة
يعاد كائن من النوع IO أو File يمثل الملف الحالي، أو القيمة $stdin إن كان الملف الحالي هو مجرى الدخل القياسي (STDIN).
أمثلة
مثال على استخدام التابع file:
$ echo "foo" > foo
$ echo "bar" > bar
$ ruby argf.rb foo bar
ARGF.file #=> #<File:foo>
ARGF.read(5) #=> "foo\nb"
ARGF.file #=> #<File:bar>
انظر أيضًا
- التابع
close: يغلق الملف الحالي ويتخطاه إلى الملف التالي فيARGV. - التابع
eof?: يتحقق إذا بلغ الملف الحالي نهايته فيARGF. - التابع
filename: يعيد اسم الملف الحالي. - التابع
fileno: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. - التابع
inplace_mode: يعيد امتداد الملف المضاف إلى أسماء الملفات المُعدَّلة وفق وضع التعديل الموضعي (in-place edit mode). - التابع
lineno: يجلب رقم السطر الحالي للمجرىARGFككُل. - التابع
pos: يعيد موضع المؤشِّر الحالي في الملف الحالي في المجرىARGF. - التابع
skip: يتخطى الملف الحالي إلى الملف التالي ويجعله هو الملفَّ الحالي في المجرىARGF. - التابع
to_io: يعيد الملف الحالي على شكل كائن من النوعIO. - التابع
to_write_io: يعيد نسخةً من الصنفIOمرتبطةً بالمجرىARGFللكتابة عليها في حال كان الوضعinplaceمفعَّلًا.