الفرق بين المراجعتين لصفحة: «Ruby/File/open»
جميل-بيلوني (نقاش | مساهمات) إنشاء الصفحة. |
جميل-بيلوني (نقاش | مساهمات) إضافة شرح |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>File.open</code> في روبي}}</noinclude> | <noinclude>{{DISPLAYTITLE: التابع <code>File.open</code> في روبي}}</noinclude> | ||
يشبه التابع <code>open</code> التابع <code>new</code> تمامًا إن لم تعطَ كتلة برمجية معه أو سيمُرَّر الملف بعد فتحه (الكائن <code>[[Ruby/File|File]]</code>) إلى الكتلة ثم سيُغلق تلقائيًّا عند انتهاء تنفيذ الكتلة. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">open(filename, mode="r" [, opt]) → file | <syntaxhighlight lang="ruby">open(filename, mode="r" [, opt]) → file | ||
open(filename [, mode [, perm]] [, opt]) → file | open(filename [, mode [, perm]] [, opt]) → file | ||
open(filename, mode="r" [, opt]) {|file| block } → obj | open(filename, mode="r" [, opt]) {|file| block } → obj | ||
open(filename [, mode [, perm]] [, opt]) {|file| block } → obj</syntaxhighlight> | open(filename [, mode [, perm]] [, opt]) {|file| block } → obj</syntaxhighlight>عندما يكون الملف قيد الإنشاء، فمن الممكن أن تُعطَى بتات الأذونات عبر المعامل <code>perm</code>. اطلع على صفحة التابع <code>[[Ruby/File/new|new]]</code> للمزيد من التفاصيل. | ||
== المعاملات == | |||
=== <code>filename</code> === | |||
اسم الملف المراد فتحه. | |||
=== <code>mode</code> === | |||
وضع الملف المراد فتحه فيه. اطلع على توثيق التابع <code>[[Ruby/IO/new|IO.new]]</code> لمزيد من المعلومات حول قيم هذا المعامل. | |||
=== <code>opt</code> === | |||
خيارات إضافية. اطلع على توثيق التابع <code>[[Ruby/IO/new|IO.new]]</code> لمزيد من المعلومات حول قيم هذا المعامل. | |||
=== <code>perm</code> === | |||
بتات الأذونات التي ستُعيَّن للملف المراد فتحه. | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
يعاد | يعاد كائن جديد من النوع <code>[[Ruby/File|File]]</code> يمثِّل الملف <code>filename</code> بعد فتحه إن لم تُعطَ الكتلة <code>block</code>، أو يعاد ناتج تنفيذ الكتلة <code>block</code>. | ||
==انظر أيضا== | ==انظر أيضا== | ||
* التابع <code>[[Ruby/File/new|new]]</code>: يفتح ملفًا محدَّدًا وبوضع معيَّن ثم يعيد كائنًا جديدًا من النوع <code>[[Ruby/File|File]]</code>. | |||
==مصادر== | ==مصادر== | ||
المراجعة الحالية بتاريخ 09:17، 29 نوفمبر 2018
يشبه التابع open التابع new تمامًا إن لم تعطَ كتلة برمجية معه أو سيمُرَّر الملف بعد فتحه (الكائن File) إلى الكتلة ثم سيُغلق تلقائيًّا عند انتهاء تنفيذ الكتلة.
البنية العامة
open(filename, mode="r" [, opt]) → file
open(filename [, mode [, perm]] [, opt]) → file
open(filename, mode="r" [, opt]) {|file| block } → obj
open(filename [, mode [, perm]] [, opt]) {|file| block } → obj
عندما يكون الملف قيد الإنشاء، فمن الممكن أن تُعطَى بتات الأذونات عبر المعامل perm. اطلع على صفحة التابع new للمزيد من التفاصيل.
المعاملات
filename
اسم الملف المراد فتحه.
mode
وضع الملف المراد فتحه فيه. اطلع على توثيق التابع IO.new لمزيد من المعلومات حول قيم هذا المعامل.
opt
خيارات إضافية. اطلع على توثيق التابع IO.new لمزيد من المعلومات حول قيم هذا المعامل.
perm
بتات الأذونات التي ستُعيَّن للملف المراد فتحه.
القيمة المعادة
يعاد كائن جديد من النوع File يمثِّل الملف filename بعد فتحه إن لم تُعطَ الكتلة block، أو يعاد ناتج تنفيذ الكتلة block.