الفرق بين المراجعتين لصفحة: «Ruby/File/birthtime»

المراجعة الحالية بتاريخ 10:06، 28 نوفمبر 2018

يعيد التابع birthtime وقت إنشاء ملف محدَّد.

إن لم تكن المنصة المستعملة تدعم تسجيل وقت إنشاء الملف للملف المراد معرفة وقت إنشائه، فسيُرمَى الاستثناء NotImplementedError.

birthtime(file_name) → time

سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف المراد معرفة زمن إنشائه.

يعاد كائن من النوع Time يمثِّل الزمن الذي أُنشئ فيه الملف file_name.

مثال على استعمال التابع birthtime:

File.birthtime("testfile")   #=> Wed Apr 09 08:53:13 CDT 2003

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع <code>File.birthtime</code> في روبي}}</noinclude>
-يعيد التابع <code>birthtime</code> ن
+يعيد التابع <code>birthtime</code> وقت إنشاء ملف محدَّد.
+إن لم تكن المنصة المستعملة تدعم تسجيل وقت إنشاء الملف للملف المراد معرفة وقت إنشائه، فسيُرمَى الاستثناء [[Ruby/NotImplementedError|<code>NotImplementedError</code>]].
 ==البنية العامة==
 <syntaxhighlight lang="ruby">birthtime(file_name) → time</syntaxhighlight>
+== المعاملات ==
+=== <code>file_name</code> ===
+سلسلة نصية أو كائن من النوع <code>[[Ruby/IO|IO]]</code> يمثِّل اسم الملف المراد معرفة زمن إنشائه.
 ==القيمة المعادة==
-يعاد
+يعاد كائن من النوع <code>[[Ruby/Time|Time]]</code> يمثِّل الزمن الذي أُنشئ فيه الملف <code>file_name</code>.
 ==أمثلة==
@@ سطر 13: / سطر 20: @@
 ==انظر أيضا==
+* التابع <code>[[Ruby/File/atime|atime]]</code>: يعيد زمن آخر وصول إلى ملفٍ محدَّدٍ.
+* التابع <code>[[Ruby/File/ctime|ctime]]</code>: يعيد وقت آخر تغيير أجري على ملف محدَّد.
 ==مصادر==