نتائج البحث

الصنف IO هو أساس كل عمليات الإدخال والإخراج في روبي. مجرى الدخل/الخرج (I/O stream) قد يكون مزدوج الاتجاه (duplexed، أي في اتجاهين)، وبذلك قد يُستخدَم أكثر من مجرى واحد من مجاري نظام التشغيل. الكثير من الأمثلة الواردة في في هذا القسم تستخدم الصنف File، وهو االصنف الفرعي (subclass) القياسي الوحيد للصنف IO، إذ يرتبط الصنفان ارتباطًا وثيقًا. مثل الصنف File، فإنّ المكتبة Socket تشتق أصنافًا فرعيةً من الصنف IO (مثل TCPSocket أو UDPSocket). يمكن أن ينشئ التابع Kernel.open كائنات من ...

يوضح هذا الدليل كيفية تضمين مُكوّن (component) عارض كوردوفا في تطبيقات منصة iOS الكبيرة. للمزيد من التفاصيل حول كيفية جعل تلك المكوّنات تتواصل مع بعضها، راجع دليل تطوير الإضافات. بدأ دعم العوارض في منصة iOS منذ الإصدار 1.4 كوردوفا، باستخدام مكوِّن Cleaver الذي بُنِي على قالب Xcode. منصة كوردوفا 2.0 والإصدارات الأحدث لا تدعم إلا التقديم المستند إلى المشروع الفرعي (subproject-based) للمكُوِّن Cleaver. تتطلب هذه الإرشادات على الأقل الإصدار الرابع من كوردوفا، والثامن من Xcode، بالإضافة إلى الملف config.xml من ...

تثبيت روبي توجد طرائق عدَّة لتنزيل وتثبيت روبي على كل منصة وهي: إمَّا استعمال أنظمة مدير الحزم، أو باستعمال المثبِّتات التلقائية، أو باستعمال مدراء روبي. هنالك طريقة أخرى يمكنك بالتأكيد استعمالها لتثبيت روبي وتصريف شيفراتها وهي بنائها من الشيفرة المصدرية مباشرةً. حول روبي يوفر هذا القسم لمحة سريعة عن لغة روبي ونشأتها، وتطورها، ومزاياها التي انفردت بها عن اللغات الأخرى، والتنفيذات المختلفة التي تملكها. البنية العامة بنية اللغة تعد روبي مزيجًا من اللغات البرمجية التالية: Perl، و Smalltalk، و Eiffel، ...

يعيد التابع to_io الملف الحالي على شكل كائن من النوع IO. البنية العامة to_io → IO القيم المعادة يعاد كائن من النوع IO يمثل الملف الحالي، أو يعاد كائنٌ من النوع ‎File إلا إذا كان الملف الحالي مجرى، مثل مجرى الدخل القياسي (STDIN). أمثلة مثال على استخدام التابع to_io: ARGF.to_io #=> #<File:glark.txt> ARGF.to_io #=> #<IO:<STDIN>> انظر أيضًا التابع file: يعيد الملف الحالي على شكل كائن من النوع IO أو File. التابع to_write_io: يعيد نسخةً من ...

يمثل الصنف Encoding ترميز المحارف الذي يمكننا استخدامه في لغة روبي. تُعرَّف النّسخة المنشأة من الصنف Encoding بأنّها ثابتٌ (constant) يندرج ضمن مجال أسماء الصنف (encoding namespace)؛ يكون لها اسم، واسم بديل (Alias) اختياري. Encoding::ISO_8859_1.name #=> "ISO-8859-1" Encoding::ISO_8859_1.names #=> ["ISO-8859-1", "ISO8859-1"] التّوابع (methods) في لغة روبي التي تتعامل مع التّرميزات تعيد أو تقبل النسخ Encoding على شكل وسيط (عندما يقبل التّابع كائنًا على شكل وسيط، يمكن عندها أن نستخدم اسم أو لقب الترميز عوضًا عن الكائن). "some string".encoding #=> #<Encoding:UTF-8> string = "some string".encode(Encoding::ISO_8859_1) #=> "some string" string.encoding #=> ...

يكتب التابع report الناتج ‎::result على المجرى ‎$stdout أو كائن من النوع IO. البنية العامة GC::Profiler.report GC::Profiler.report(io) المعاملات io كائن من النوع IO يراد كتابة الناتج فيه. انظر أيضا التابع result: يعيد تقرير بيانات ملف التعريف. التابع total_time: يعيد إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني. مصادر قسم التابع report في الصنف GC::Profiler في توثيق روبي الرسمي.

ينشئ التابع open كائنًا من النوع IO متصلًا بالمجرى أو الملف أو العملية الفرعية (subprocess) المحددة. البنية العامة open(path [, mode [, perm]] [, opt]) → io or nil open(path [, mode [, perm]] [, opt]) {|io| block } → obj‎ في حال إعطاء كتلة، فستُسدعَى بتمرير كائن من النوع IO كوسيط إليها، والذي سيُغلق تلقائيًا عند الانتهاء من تنفيذ الكتلة ثم سيعاد الناتج. إذا بُدئ الوسيط path بشرطة عمودية ("|") ، فسيتم إنشاء عملية فرعية (subprocess)، متصلة بالمُستدعي (caller) بواسطة ...

يعيد التابع to_write_io نسخةً من الصنف IO مرتبطةً بالمجرى ARGF للكتابة عليها في حال كان الوضع inplace مفعَّلًا. البنية العامة to_write_io → io القيم المعادة يعاد كائن من النوع IO مرتبط بالمجرى ARGF. انظر أيضًا التابع write: يكتب السلسلة النصية الممرَّرة إليها على المجرى ARGF في حال كان الوضع inplace مفعَّلًا. التابع file: يعيد الملف الحالي على شكل كائن من النوع IO أو File. التابع fileno: يعيد عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. التابع ...

يعيد التابع 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 ...

يكتب التابع putc محرفًا واحدًا على المجرى ios (اختصارًا للعبارة Input Output Stream). البنية العامة putc(obj) → obj المعاملات obj إن كان المعامل obj قيمةً عدديةً، فسيكتب التابع putc المحرف الذي تتساوى قيمته العددية مع القيمة العددية للبايت الأقل أهمية (least-significant) من الكائن obj على المجرى ios. أمَّا إن كان المعامل obj سلسلةً نصيةً، فسيكتب التابع المحرف الأول من هذه السلسلة على المجرى ios. إن لم يكن obj سلسلةً نصيةً ولا عددًا، فسيُطلَق الخطأ TypeError. القيم المعادة يعاد الكائن obj ...

ينفذ التابع popen الأمر المعطى كعملية فرعية (subprocess) مع توصيل المجرَيَين القياسيين للدخل والخرج للعملية الفرعية مع المجرى IO المُعاد. يمكن الحصول على على معرف العملية (PID) عبر التابع pid. في حال إعطاء كتلة، فستُنفذ روبي التعليمة كعملية فرعية مرتبطة بروبي عبر أنبوب (pipe). سيُمرّر الطرف المقابل لروبي كوسيط إلى الكتلة. في نهاية الكتلة، ستغلق روبي الأنبوب وتعيّن قيمة ‎$?‎‎. في هذه الحالة، سيعيد التابع popen قيمة الكتلة. البنية العامة popen([env,] cmd, mode="r" [, opt])→ io popen([env,] cmd, mode="r" [, opt]) {|io| ...

يكتب المعامل >> كائنًا في المجرى IO المعطى. يُحول ذلك الكائن إلى سلسلة نصية باستخدام التابع to_s. البنية العامة ios << obj → ios‎ القيمة المعادة يعاد المجرى ios بعد كتابة الكائن obj فيه. أمثلة مثال على استخدام التابع ‎<<‎: $stdout << "Hello " << "world!\n"‎ انظر أيضًا التابع write: يفتح ملفًا محدَّدًا ويكتب فيه السلسلة النصية المُمرَّرة إليه ثم يغلقه ويعيد عدد البايتات التي كتبها. مصادر قسم المعامل >> في الصنف IO‎ في توثيق روبي الرسمي.

يشبه التابع open التابع new تمامًا عند استدعائه دون كتلة، أو يُمرّر الكائن IO الذي جرى إنشاؤه كوسيط إلى الكتلة المعطاة ثم يعيد الناتج الذي تعيده الكتلة. سيتم إغلاق ذلك المجرى تلقائيًا عند إنهاء الكتلة منه. وفي هذه الحالة. البنية العامة open(fd, mode="r" [, opt]) → io open(fd, mode="r" [, opt]) {|io| block } → obj‎ المعاملات fd‎ واصف الملف المراد فتحه. mode‎ وضع الفتح الذي يحدد الكيفية والغرض من فتح الملف ذي الواصف fd. القيمة الافتراضية هي: "r". لمعرفة ...

يُسلسل (Serializes) التابع dump الكائن المعطى وجميع الكائنات المنحدرة منه (descendant objects). في حال تمرير كائن من النوع IO، فستُكتب البيانات المُسَلسلة فيه، وإلا فستُعاد البيانات كسلسلة نصية. البنية العامة dump( obj [, anIO] , limit=-1 ) → anIO‎ في حال تمرير المعامل limit، فسيقتصر التابع dump على سَلسَلة الكائنات الفرعية حتى العمق المحدد. إذا كان limit سالبًا، لن يكون هناك أي تحقق من للعمق. لا يمكن للتابع Marshal تفريغ (dump) الكائنات التالية: الوحدات أو الأصناف المجهولة (anonymous Class/Module). الكائنات المرتبطة بالنظام (مثل ...

يكتب التابع puts الكائن أو الكائنات المُمرَّرة إليه على المجرى ios (اختصارًا للعبارة Input Output Stream) ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. يجب أن يكون المجرى مفتوحًا وفي وضعية الكتابة. إن مرِّرت مصفوفةٌ إلى التابع puts كوسيط، فسيطبع كلَّ عنصر في سطر جديد. إن لم يكن الكائن المعطى سلسلةً نصيةً أو مصفوفة، فسيُحوَل إلى سلسلة نصية باستدعاء التابع to_s تلقائيًّا. عند استدعاء التابع puts دون تمرير وسائط، سيطبع سطرًا جديدًا ...

يكافئ التابع printf التعبير التالي: io.write(sprintf(string, obj, ...))‎ أو التعبير التالي: $stdout.write(sprintf(string, obj, ...))‎ البنية العامة printf(io, string [, obj ... ]) → nil printf(string [, obj ... ]) → nil‎ المعاملات io‎ مجرى من النوع IO ستكتب عليه البيانات. string‎ السلسلة النصية المراد طباعتها. obj ...‎ كائنات أخرى يراد طباعتها. القيمة المعادة تعاد القيمة nil بعد طباعة السلسلة string على مخرج الخرج القياسي أو المجرى io إن أعطي. انظر أيضا التابع print: يطبع الكائنات الممرة إليه بالتتابع على المجرى stdout$. ...

يطبع التابع printf الكائن أو الكائنات الممرَّرة إليه على المجرى ios (اختصارًا للعبارة Input Output Stream) بعد تنسيقها بشكل معين. للمزيد من المعلومات حول المعاملات المستعملة في عملية التنسيق (أي المستعملة مع الوسيط format_string)، ارجع إلى صفحة التابع Kernel.sprintf. البنية العامة printf(format_string [, obj, ...]) → nil القيم المعادة تعاد القيمة nil. أمثلة مثالٌ على استخدام التابع printf: printf("%s, the sale price is $%f.\n", name, sale_price) ...

ينفذ التابع each الكتلة المعطاة على كل سطر في المجرى الذي استُدعي معه. يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة each(sep=$/ [, getline_args]) {|line| block } → ios each(limit [, getline_args]) {|line| block } → ios each(sep, limit [, getline_args]){|line| block } → ios each(...) → an_enumerator each_line(sep=$/ [, getline_args]) {|line| block } → ios each_line(limit [, getline_args]){|line| block } → ios each_line(sep, ...

ينشئ التابع new كائنًا جديدًا من النوع IO انطلاقًا من واصف الملف (file descriptor) ووضع الفتح الممرَّرين إليه. يُستدعَى التابع new عبر العديد من توابع الفتح الخاصة بالصنفين File و IO، مثل open و Kernel.open و File.open. البنية العامة new(fd [, mode] [, opt])→ io‎ المعاملات fd‎ واصف الملف المراد فتحه. mode‎ وضع الفتح الذي يحدد الكيفية والغرض من فتح الملف ذي الواصف fd. وضع الفتح (Open Mode) إن كان المعامل mode عددًا صحيحًا، فيجب أن يكون مزيجًا من الأوضاع المعرفة ...

يعيد التابع reopen ربط المجرى الذي استُدعي معه مع مجرى آخر جديد أو موجود مسبقًا. قد يؤدي هذا إلى تغيير الصنف الفعلي لهذا المجرى ديناميكيًا. البنية العامة reopen(other_IO)→ ios reopen(path, mode_str)→ ios‎ المعاملات other_IO‎ كائن من النوع IO يمثِّل مجرى موجود مسبقًا يراد ربطه بالمجرى المعطى. path‎ مسار يشير إلى مجرى جديد لفتحه من أجل ربطه بالمجرى المعطى. mode_str‎ سلسلة نصية تمثل وضعية الفتح. اطلع على صفحة التابع new للمزيد حول أوضاع الفتح. القيمة المعادة يعاد المجرى المعطى بعد إعادة ربطه بالمجرى ...

يحرِّك التابع seek مؤشر المجرى الذي استدعي معه إلى موضع محدَّد. البنية العامة seek(amount, whence=IO::SEEK_SET) → 0‎ المعاملات amount‎ عدد صحيح يحدِّد مقدار إزاحة المؤشر بدءًا من بداية الملف (القيمة الافتراضية للمعامل whence‎) أو من نهاية الملف أو من الموضع الحالي للموشر نفسه بحسب قيمة المعامل whence‎. whence‎ راية تحدد الموضع الذي سيزاح المؤشر بدءًا منه بالمقدار amount. القيم التي يمكن استعمالها مع هذا المعامل موضحة بالجدول التالي: المعامل whence شرح ‎:CUR أو IO::SEEK_CUR يحرَّك المؤشر بمقدار amount + موضع ...

يطبع التابع print الكائن أو الكائنات المُمرَّرة إليه على المجرى ios (اختصار للعبارة Input Output Stream). يجب أن يكون المجرى مفتوحًا وفي وضعية الكتابة. إن لم يكن الكائن المعطى سلسلةً نصيةً، فسيُحوَل إلى سلسلة نصية باستدعاء التابع to_s تلقائيًّا. عند استدعاء التابع print دون تمرير أي وسائط، سيُطبَع محتويات المعامل ‎$_‎. إذا لم يكن فاصل حقل المخرجات (,$) يساوي القيمة nil، فسيُدرج بين الكائنات المُمررة. وإذا لم يكن فاصل سجل المخرجات (\$) يساوي القيمة nil، فسيُضاف إلى المُخرج النهائي. البنية ...

ينسخ التابع copy_stream بيانات من مجرى إلى مجرى آخر. البنية العامة copy_stream(src, dst) copy_stream(src, dst, copy_length) copy_stream(src, dst, copy_length, src_offset)‎ المعاملات src‎ اسم ملف أو كائن مشابه للصنف IO يمثِّل المصدر الذي سيُقرَأ منه. الكائنات المشابهة للصنف IO المُمررة إلى هذا المعامل يجب أن تُعرّف التابع readpartial أو read. dst‎ اسم ملف أو كائن مشابه للصنف IO يمثِّل الوجه التي ستُكتَب فيها البيانات التي قُرأَت من المصدر src. يجب أن يكون للكائنات المشابهة للصنف IO الممررة إلى المعامل dst التابع write. (في ...

يعيد التابع restore نتيجة تحويل البيانات المُسلسلة (serialized) في المصدر إلى كائن روبي (ربما مع كائنات ثانوية [subordinate objects] مرتبطة به). قد يكون المصدر إما كائنًا من الصنف IO، أو كائنًا يستجيب إلى التابع to_str. في حال تمرير المعامل، فسيتم تمرير كل الكائنات إليه أثناء فك تسلسلها (deserialisation). تنبيه: لا تمرّر أبدًا إلى التابع restore بيانات غير موثوقة (بما في ذلك المدخلات التي يرسلها المستخدم). البنية العامة restore( source [, proc] ) → obj‎ المعاملات source‎ إمَّا كائنٌ من الصنف IO، أو كائنٌ يستجيب إلى التابع to_str يمثل المصدر. proc‎ ...

يحرِّك التابع seek المؤشِّر الحالي في المجرى ARGF إلى موقع محدد. البنية العامة seek(amount, whence=IO::SEEK_SET) → 0 المعاملات amount قيمة إزاحة موقع المؤشِّر بالبايت. إن أردت تحريك المؤشِّر انطلاقًا من نهاية الملف، فمرِّر قيمة سالبة للمعامل amount ثمَّ حدِّد القيمة ‎:END أو IO::SEEK_END للمعامل whence. whence قيمة هذا المعامل هي إحدى القيم التالية: ‎:SET أو IO::SEEK_SET: تغيير موقع المؤشِّر إلى قيمة المعامل amount المعطاة بالبايت انطلاقًا من البداية. ‎:CUR أو IO::SEEK_CUR: تغيير موقع المؤشِّر إلى قيمة المعامل amount المعطاة بالبايت ...

يكتب التابع write السلسلة النصية الممرَّرة إليها على المجرى ARGF في حال كان الوضع inplace مفعَّلًا. البنية العامة write(string) → integer القيم المعادة يعاد عدد صحيح يمثل عدد البايتات التي كتبت على المجرى ARGF. انظر أيضًا التابع to_write_io:يعيد نسخةً من الصنف IO مرتبطةً بالمجرى ARGF للكتابة عليها في حال كان الوضع inplace مفعَّلًا. التابع read: يقرأ عددًا محددًا من البايتات من المجرى ARGF. التابع gets: يجلب السطر التالي من الملف الحالي في المجرى ARGF. التابع puts: يكتب الكائن أو ...

يحاول التابع try_convert تحويل الكائن المُمرَّر إليه إلى مجرى د/خ باستخدام التابع to_io. البنية العامة try_convert(obj) → io or nil‎ المعاملات obj‎ كائن يراد تحويله إلى كائن من النوع IO. القيمة المعادة يعاد المجرى المُحوّل عن الكائن obj، أو تعاد القيمة nil إذا تعذر تحويل الكائن obj لأي سبب من الأسباب. أمثلة مثال على استخدام التابع try_convert‎: IO.try_convert(STDOUT) #=> STDOUT IO.try_convert("STDOUT") #=> nil require 'zlib' f = open("/tmp/zz.gz") #=> #<File:/tmp/zz.gz> z = ...

يعيد التابع load نتيجة تحويل البيانات المُسلسلة (serialized) في المصدر إلى كائن روبي (ربما مع كائنات ثانوية [subordinate objects] مرتبطة به). قد يكون المصدر إمَّا كائنًا من الصنف IO، أو كائنًا يستجيب إلى التابع to_str. في حال تمرير المعامل الثاني، فسيتم تمرير كل كائن من الكائنات إليه أثناء فك تسلسلها (deserialisation). تنبيه: لا تمرّر أبدًا إلى التابع load بيانات غير موثوقة (بما في ذلك المدخلات التي يرسلها المستخدم). البنية العامة load( source [, proc] ) → obj‎ المعاملات source‎ إمَّا كائنٌ من ...

يعيد التابع to_io المجرى نفسه الذي استُدعي معه. لمَّا كان هذا التابع يحوِّل الكائن الذي استدعي معه إلى كائن من النوع IO، فإنه سيعيد الكائن IO نفسه إن استدعي معه. البنية العامة to_io → ios‎ القيمة المعادة يعاد المجرى المعطى نفسه. انظر أيضًا التابع tty?‎: يتحقق إن كان المجرى الذي استدعي معه مرتبطًا بجهاز طرفي (tty). مصادر قسم التابع to_io‎ في الصنف IO‎ في توثيق روبي الرسمي.

يٌطلَق الخطأ EOFError من طرف بعض عمليات الصنف IO عندما تصل إلى نهاية الملف. تنقسم أغلب توابع الصنف IO -فيما يتعلق بالوصول إلى نهاية الملف- إلى قسمين: الأول يعيد القيمة nil عند الوصول إلى نهاية الملف، والآخر يطلق الخطأ EOFError عند الوصول إلى نهاية الملف. الصنف EOFError هو صنف فرعي من الصنف IOError. file = File.open("/etc/hosts") file.read file.gets #=> nil file.readline #=> EOFError: الوصول إلى نهاية الملف مصادر الصنف EOFError في توثيق روبي الرسمي.

يضبط التابع set_encoding الترميز الداخلي والخارجي في المجرى الذي استدعي معه. في حال تمرير وسيط واحد إلى التابع، فستوسم السلسلة النصية المقروءة من المجرى بالترميز المحدد. إن كان الترميز على هيئة حرفي ترميز مفصولين بنقطتين رأسيتين مثل "A:B"، فستُحوّل السلسلة النصية المقروءة من الترميز A (الترميز الخارجي) إلى الترميز B (الترميز الداخلي)، ثم ستوسم بالترميز B. في حال تمرير وسيطين، فيجب أن يكونا كائني ترميز، أو اسمي ترميز، إذ يمثل أولهما الترميز الخارجي، فيما يمثل ثانيهما الترميز الداخلي. في حال ...

يستدعي التابع select دالة النظام select(2)‎، إذ يعمل على مراقبة المصفوفات الكائنات IO المعطاة، وينتظر حتى يصبح أحد تلك الكائنات أو أكثر جاهزًا للقراءة، وجاهزًا للكتابة، ومالكًا لاستثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة تحتوي على مصفوفات مكونة من الكائنات IO السابقة. سيعيد التابع القيمة nil إذا تم إعطاء قيمة للمهلة الزمنية timeout، ولم يكن هناك أي كائن جاهز خلال هذه الفترة. يراقب التابع IO.select المخزن المؤقت (buffer) للكائنات IO لاختبار قابليتها للقراءة. إذا لم يكن المخزن المؤقت ...

يكتب التابع write_nonblock السلسلة النصية المُمرَّرة إليه في المجرى الذي استُدعي معه باستخدام استدعاء النظام write(2)‎ بعد تعيين قيمة الراية O_NONBLOCK الخاصة بواصف الملف (file descriptor) الأساسي. يستدعي التابع write_nonblock استدعاء النظام write(2)‎. ويتسبب في كافة الأخطاء التي يتسبب فيها استدعاء النظام write(2)‎، مثل Errno::EWOULDBLOCK و Errno::EINTR وغيرهما. قد تكون النتيجة أصغر من طول السلسلة النصية (أي أن الكتابة جزئية). لذا يجب أن يعالج المستدعي هذه الأخطاء، إضافة إلى مسألة الكتابة الجزئية. إن كان الاستثناء يساوي Errno::EWOULDBLOCK أو Errno::EAGAIN، فسيتم توسيعه ...

يفتح التابع sysopen الملف الموجود في المسار المحدد، ثم يعيد واصف الملف الأساسي كعدد صحيح. البنية العامة sysopen(path, [mode, [perm]]) → integer‎ المعاملات path‎ المسار المراد فتحه. mode‎ وضع الفتح. اطلع على صفحة التابع new للمزيد من التفاصيل حول هذا المعامل. perm أذونات الملف. القيمة المعادة يعاد عدد صحيح يمثِّل واصف الملف ذي المسار path بعد فتحه. أمثلة مثال على استخدام التابع sysopen‎: IO.sysopen("testfile") #=> 3‎ انظر أيضًا التابع new: ينشئ كائنًا جديدًا من النوع IO. التابع open: ...

ينفذ التابع each_line الكتلة المعطاة على كل سطر في المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة each_line(sep=$/ [, getline_args]) {|line| block } → ios each_line(limit [, getline_args]){|line| block } → ios each_line(sep, limit [, getline_args]) {|line| block } → ios each_line(...)→ an_enumerator‎ المعاملات sep‎ محرف يمثِّل الفاصل بين الأسطر. القيمة الافتراضية هي: /$. limit‎ عدد صحيح يمثل الحد ...

ينشئ التابع pipe زوجًا من طرفي أنبوب (pipe endpoints) متصلين ببعضهما بعضًا ثم يعيدهما على هيئة مصفوفة من الكائنات IO. في حال إعطاء كتلة، ستُستدعى تلك الكتلة، وتعاد قيمتها، مع تمرير أنبوب القراءة وأنبوب الكتابة بعد إنشائهما كوسائط من النوع IO إليها. وسيتم إغلاقهما إن لم يغلقا عند خروج الكتلة. أي أن إغلاق هذين المجريين لن يتسبب في حدوث خطأ. التابع pipe غير متوفر في جميع أنظمة التشغيل. إذا تم تمرير ترميز معين (اسم ترميز أو كائن ترميز) كمعامل إلى التابع، فسيتم ...

يقرأ التابع read_nonblock عددًا محدَّدًا من البايتات من المجرى الذي استُدعي معه باستخدام استدعاء النظام read(2)‎ بعد تعيين الراية O_NONBLOCK لواصف الملف (file descriptor) الأساسي. يستدعي التابع read_nonblock استدعاء النظام read(2)‎. كما أنه يتسبب في كل الأخطاء التي يسببها استدعاء النظام read(2)‎، مثل Errno::EWOULDBLOCK و Errno::EINTR وغيرهما . لذا، يجب على المُستدعي التعامل مع هذه الأخطاء. إن كان الاستثناء هو أحد الاستثنائين Errno::EWOULDBLOCK أو Errno::EAGAIN، فسيتم توسيعه بواسطة التابع WaitReadable، حتى يمكن استخدامه لمعالجة الاستثناءات لأجل إعادة استدعاء التابع read_nonblock. يطلق التابع ...

يستدعي التابع select استدعاء النظام select(2)‎. ويراقب المصفوفة المعطاة المكونة من مجاري د/خ (كائنات IO)، وينتظر حتى يكون واحد أو أكثر من تلك المجاري جاهزًا للقراءة، وجاهزًا للكتابة، ويكون له استثناءات معلقة (pending exceptions) على التوالي، ثم يعيد مصفوفة مؤلفة من مصفوفات مكونة من تلك المجاري. ستعاد القيمة nil إذا تم إعطاء قيمة للمعامل timeout الاختياري (انظر فقرة البنية العامة)، ولم يكن أيٌّ من مجاري د/خ جاهزًا خلال تلك المهلة الزمنية. يراقب التابع select المخزن المؤقت (buffer) لمجرى د/خ لاختبار قابليته ...

يتحقق التابع identical?‎ إن كان الملفان المعطيان متماثلين تمامًا. البنية العامة identical?(file_1, file_2) → true or false المعاملات file_1 الملف الأول المراد التحقق من مطابقته للملف file_2. يمكن أن يكون من النوع IO. file_2 الملف الثاني المراد التحقق من مطابقته للملف file_1. يمكن أن يكون من النوع IO. القيمة المعادة تعاد القيمة true إن كان الملف file_1 مطابقًا ومماثلًا للملف file_1. خلا ذلك، تعاد القيمةfalse. أمثلة مثال على استعمال التابع identical?‎: open("a", "w") {} p File.identical?("a", "a") #=> true p File.identical?("a", "./a") #=> ...

يمرر التابع each_codepoint كل عدد من الأعداد الترتيبية (Integer ordinal، وتُعرف أيضًا باسم "نقاط الترميز" [codepoints] في السلاسل النصية المرمزة بالترميز الموحد [Unicode]) لكل محرف من المحارف الموجودة في المجرى الذي استدعي معه إلى الكتلة المعطاة. يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة each_codepoint {|c| block } → ios codepoints {|c| block } → ios each_codepoint→ an_enumerator codepoints → an_enumerator‎ ...

يُطلق الاستثناء IOError عند فشل عملية إدخال/إخراج (IO operation) في روبي. File.open("/etc/hosts") {|f| f << "example"} #=> IOError: not opened for writing File.open("/etc/hosts") {|f| f.close; f.read } #=> IOError: closed stream تذكر أنَّ فشل بعض عمليات الإدخال/الإخراج قد يؤدي إلى إطلاق الاستثناء SystemCallError، وهذا الاستثناء ليس متفرع من الصنف IOError. File.open("does/not/exist") #=> Errno::ENOENT: No such file or directory - does/not/exist مصادر صفحة الصنف IOError في توثيق روبي الرسمي.

يعد التابع for_fd مرادفًا للتابع new. البنية العامة for_fd(fd, mode [, opt]) → io‎ انظر أيضًا التابع copy_stream: ينسخ بيانات من مجرى إلى مجرى آخر. التابع new: ينشئ كائن جديد من النوع IO. مصادر قسم التابع for_fd‎ في الصنف IO‎ في توثيق روبي الرسمي.

يحرِّك التابع sysseek مؤشر المجرى الذي استدعي معه إلى موضع محدَّد. البنية العامة sysseek(offset, whence=IO::SEEK_SET)→ integer‎ المعاملات offset‎ عدد صحيح يحدِّد مقدار إزاحة المؤشر بدءًا من بداية الملف (القيمة الافتراضية للمعامل whence‎) أو من نهاية الملف أو من الموضع الحالي للموشر نفسه بحسب قيمة المعامل whence‎. whence‎ راية تحدد الموضع الذي سيزاح المؤشر بدءًا منه بالمقدار amount. اطلع على صفحة التابع seek للاطلاع على القيم التي يمكن أن يأخذها هذا المعامل. القيمة المعادة يعاد عدد صحيح يمثِّل موضع المؤشر الجديد بعد تحريكه إليه. أمثلة مثال على ...

يتحقق التابع blockdev?‎ إن كان ملفٌ ما هو جهاز كتلي (block device). البنية العامة blockdev?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name هو جهاز كتلي (block device). خلا ذلك، تعاد القيمةfalse. انظر أيضًا مصادر قسم التابع blockdev?‎ في الصنف FileTest في توثيق روبي الرسمي.

يغلق التابع close الملف الحالي ويتخطاه إلى الملف التالي في ARGV. إن لم تتبقَ ملفات أخرى لفتحها، فسيكتفي التابع بإغلاق الملف الحالي. انتبه إلى أنَّ مجرى الدخل القياسي (STDIN) لن يُغلَق أبدًا. البنية العامة close → ARGF أمثلة مثال على استخدام التابع close: $ ruby argf.rb foo bar ARGF.filename #=> "foo" ARGF.close ARGF.filename #=> "bar" ARGF.close انظر أيضًا التابع close?‎: يتحقق‎ إن أُغلِق الملف الحالي أم لا. التابع eof?‎: يتحقق إذا بلغ الملف الحالي نهايته في ARGF. التابع file: يعيد الملف الحالي ...

يغلق التابع close الملف الحالي ويتخطاه إلى الملف التالي في ARGV. إن لم تتبقَ ملفات أخرى لفتحها، فسيكتفي التابع بإغلاق الملف الحالي. انتبه إلى أنَّ مجرى الدخل القياسي (STDIN) لن يُغلَق أبدًا. البنية العامة close → ARGF أمثلة مثال على استخدام التابع close: $ ruby argf.rb foo bar ARGF.filename #=> "foo" ARGF.close ARGF.filename #=> "bar" ARGF.close انظر أيضًا التابع close?‎: يتحقق‎ إن أُغلِق الملف الحالي أم لا. التابع eof?‎: يتحقق إذا بلغ الملف الحالي نهايته في ARGF. التابع file: يعيد الملف الحالي ...

يتحقق التابع chardev?‎ إن كان ملفٌ ما هو جهاز محرفي (character device). البنية العامة chardev?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name هو جهاز محرفي. خلا ذلك، تعاد القيمة false.  انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). مصادر قسم التابع chardev?‎ في الصنف File في توثيق روبي الرسمي.

يتحقق التابع chardev?‎ إن كان ملفٌ ما هو جهاز محرفي (character device). البنية العامة chardev?(file_name) → true or false  المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name هو جهاز محرفي. خلا ذلك، تعاد القيمة false.  انظر أيضًا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). مصادر قسم التابع chardev?‎ في الصنف FileTest في توثيق روبي الرسمي.

يعيد التابع total_time إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني. البنية العامة GC::Profiler.total_time → float القيمة المعادة يعاد عدد عشري يمثِّل إجمالي الوقت المستخدم لتجميع البيانات المهملة بالثواني. انظر أيضا التابع report: يكتب الناتج ‎::result على المجرى ‎$stdout أو كائن من النوع IO. التابع result: يعيد تقرير بيانات ملف التعريف. مصادر قسم التابع total_time في الصنف GC::Profiler في توثيق روبي الرسمي.

الصنف ARGF هو مجرى (stream) صُمِّم ليُستخدَم في الملفات البرمجية (scritps) التي تُعالج الملفات المُمرَّرة إليها على شكل وسائط في سطر الأوامر (command-line arguments)، أو المُمرَّرة عبر مجرى الدخل القياسي (STDIN). تُخزَّن الوسائط المُمرَّرة للملف البرمجي في المصفوفة ARGV، إذ يخزَّن وسيط واحد في كل عنصر. تفترض ARGF أنّ الوسائط التي ليست أسماء ملفات (filenames) قد أزيلت من ARGV. انظر الشيفرة التالية مثلًا: $ ruby argf.rb --verbose file1 file2 ARGV #=> ["--verbose", "file1", "file2"] option = ARGV.shift #=> "--verbose" ARGV #=> ...

يعيد التابع inplace_mode امتداد الملف المضاف إلى أسماء الملفات المُعدَّلة وفق وضع التعديل الموضعي (in-place edit mode). يمكن تعيين هذه القيمة التي يعيدها التابع inplace_mode عبر استدعائه بالشكل inplace_mode = ext‎ أو بتمرير الخيار i- إلى الملف التنفيذي لمفسِّر روبي. البنية العامة inplace_mode → String القيم المعادة تعاد سلسلة نصية تحوي امتداد الملف المضاف إلى أسماء الملفات المُعدَّلة وفق وضع التعديل الموضعي (in-place edit mode). انظر أيضًا التابع inplace_mode: يضبط عند استدعائه بالشكل inplace_mode = ext امتداد اسم الملف ...

يتحقق التابع blockdev?‎ إن كان ملفٌ ما هو جهاز كتلي (block device). البنية العامة blockdev?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name هو جهاز كتلي (block device). خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع blockdev?‎: File.birthtime("testfile") #=> Wed Apr 09 08:53:13 CDT 2003 انظر أيضا التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز محرفي (character ...

يعيد التابع result تقرير بيانات ملف التعريف. البنية العامة GC::Profiler.result → String القيمة المعادة يعاد تقرير بيانات ملف التعريف مثل: GC 1 invokes. Index Invoke Time(sec) Use Size(byte) Total Size(byte) Total Object GC time(ms) 1 ...

يعيد التابع path اسم الملف الحالي. البنية العامة path → String القيم المعادة تعاد سلسلة نصية تمثل اسم الملف الحالي، أو القيمة "-" إن كان الملف الحالي هو مجرى الدخل القياسي (STDIN). أمثلة مثالٌ على استخدام التابع path: $ echo "foo" > foo $ echo "bar" > bar $ echo "glark" > glark $ ruby argf.rb foo bar glark ARGF.filename #=> "foo" ARGF.read(5) #=> "foo\nb" ARGF.filename #=> "bar" ARGF.skip ARGF.filename #=> "glark" انظر أيضًا التابع filename: يعيد اسم الملف الحالي. التابع file: يعيد ...

يعيد التابع atime زمن آخر وصول إلى ملفٍ محدَّدٍ. البنية العامة atime(file_name) → time المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف المراد معرفة آخر مرة جرى فيها الوصول إليه. القيمة المعادة يعاد كائن من النوع Time يمثِّل زمن آخر وصول للملف file_name. أمثلة مثال على استعمال التابع atime: File.atime("testfile") #=> Wed Apr 09 08:51:48 CDT 2003 انظر أيضا التابع birthtime: يعيد وقت إنشاء ملف محدَّد. التابع ctime: يعيد وقت آخر تغيير أجري على ملف ...

يعيد التابع constants مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. تتضمن هذه القائمة أسماء جميع الوحدات والأصناف المحددة في النطاق العام (global scope). البنية العامة constants→ array القيمة المعادة تعاد مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. أمثلة مثال على استخدام التابع constants‎: Module.constants.first(4) # => [:ARGF, :ARGV, :ArgumentError, :Array] Module.constants.include?(:SEEK_SET) # => false class IO Module.constants.include?(:SEEK_SET) # => true end‎ انظر أيضا التابع const_set: يضبط قيمة الثابت المعطى عند الكائن المحدد، ...

يعيد التابع mtime وقت التعديل للملف المحدَّد. البنية العامة mtime(file_name) → time المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف المراد تطبيق العملية عليه. القيمة المعادة يعاد كائن من النوع Time يمثِّل وقت تعديل الملف file_name. أمثلة مثال على استعمال التابع mtime: File.mtime("testfile") #=> Tue Apr 08 12:58:04 CDT 2003 انظر أيضا التابع atime: يعيد زمن آخر وصول إلى ملفٍ محدَّدٍ. التابع ctime: يعيد وقت آخر تغيير أجري على ملف محدَّد. التابع lutime: يعين وقتي ...

يتحقق التابع world_readable?‎ إن كان ملفٌ ما قابلًا للقراءة من طرف الآخرين. البنية العامة world_readable?(file_name) → integer or nil المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون هذا المعامل كائنًا من النوع IO. القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف file_name إن كان قابلًا للقراءة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالةstat(2)‎ في المنصات الشبيهة بيونكس. انظر أيضًا التابع readable_real?‎: يتحقق إن كان ملفٌ ما قابلًا للقراءة من طرف مُعرِّف المستخدم والمجموعة الحقيقي ...

يعيد التابع birthtime وقت إنشاء ملف محدَّد. إن لم تكن المنصة المستعملة تدعم تسجيل وقت إنشاء الملف للملف المراد معرفة وقت إنشائه، فسيُرمَى الاستثناء NotImplementedError. البنية العامة birthtime(file_name) → time المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف المراد معرفة زمن إنشائه. القيمة المعادة يعاد كائن من النوع Time يمثِّل الزمن الذي أُنشئ فيه الملف file_name.  أمثلة مثال على استعمال التابع birthtime: File.birthtime("testfile") #=> Wed Apr 09 08:53:13 CDT 2003 انظر أيضا التابع atime: يعيد ...

يعيد التابع pid معرف العملية (PID) الخاص بالعملية الفرعية (child process) المرتبطة بالمجرى الذي استدعي معه. سيتم تعيينه بواسطة التابع popen. البنية العامة pid → integer‎ القيمة المعادة يعاد عدد صحيح يمثِّل معرف العملية (PID) الخاص بالعملية الفرعي المرتبطة بالمجرى المعطى. أمثلة مثال على استخدام التابع pid‎: pipe = IO.popen("-") if pipe $stderr.puts "In parent, child pid is #{pipe.pid}" else $stderr.puts "In child, pid is #{$$}" end‎ الناتج: In child, pid is 26209 In parent, child pid is 26209‎ انظر أيضًا التابع popen: ينفذ ...

يتحقق التابع pipe?‎ إن كان ملفٌ ما أنبوبًا (pipe). البنية العامة pipe?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما أنبوبًا (pipe). خلا ذلك، تعاد القيمة false. انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع zero?‎: يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من ...

يتحقق التابع pipe?‎ إن كان ملفٌ ما أنبوبًا (pipe). البنية العامة pipe?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما أنبوبًا (pipe). خلا ذلك، تعاد القيمة false. انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع exist?‎: يتحقق إن كان ملفٌ ما موجودًا. ...

يضبط التابع inplace_mode عند استدعائه بالشكل inplace_mode = ext امتداد اسم الملف بوضعية التعديل الموضعي (in-place editing mode) إلى السلسلة النصية ext المعطاة. تضاف هذه القيمة المعطاة إلى أسماء كل الملفات التي يتم تعديلها، ويُحفَظ الملف المُعدَّل تحت هذا الاسم الجديد. البنية العامة inplace_mode = ext → ARGF القيمة المعادة يعاد المجرى ARGF. أمثلة ستُبدِّل الشيفرة التالية العبارة "bar" مكان أول ظهور للعبارة "foo" في كل سطر من أسطر الملف file.txt ثمَّ سيُكتب السطر الجديد في الملف file.txt.bak: $ ruby ...

يعيد التابع filename اسم الملف الحالي. البنية العامة filename → String القيمة المعادة تعاد سلسلة نصية تمثل اسم الملف الحالي، أو القيمة "-" إن كان الملف الحالي هو مجرى الدخل القياسي (STDIN). أمثلة مثالٌ على استخدام التابع filename: $ echo "foo" > foo $ echo "bar" > bar $ echo "glark" > glark $ ruby argf.rb foo bar glark ARGF.filename #=> "foo" ARGF.read(5) #=> "foo\nb" ARGF.filename #=> "bar" ARGF.skip ARGF.filename #=> "glark" انظر أيضًا التابع path: يعيد اسم الملف الحالي. التابع file: يعيد ...

يجلب التابع getbyte بايتًا واحدًا (8 بتّات) من المجرى ARGF. البنية العامة getbyte → Integer or nil القيم المعادة يعاد عدد صحيح يترواح بين 0 إلى 255 يمثِّل بايتًا واحدًا قُرِأ من المجرى ARGF، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى. أمثلة مثالٌ على استخدام التابع getbyte: $ echo "foo" > file $ ruby argf.rb file ARGF.getbyte #=> 102 ARGF.getbyte #=> 111 ARGF.getbyte #=> 111 ARGF.getbyte #=> 10 ARGF.getbyte #=> nil انظر أيضًا التابع getc: يجلب المحرف التالي من المجرى ARGF. التابع gets: يجلب ...

يتحقق التابع directory?‎ إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. البنية العامة directory?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون كائنًا من النوع IO. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع directory?‎: File.directory?(".") انظر أيضا التابع blockdev?‎: يتحقق إن كان ملفٌ ما هو جهاز كتلي (block device). التابع chardev?‎: يتحقق إن كان ملفٌ ما هو جهاز ...

يشبه التابع lstat التابع stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من النوع File::Stat للوصلة نفسها وليس للملف الذي تشير إليه). البنية العامة lstat(file_name) → stat المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name نفسه سواءً أكان ملفًا أو وصلةً رمزيةً. أمثلة مثال على استعمال التابع lstat: File.symlink("testfile", "link2test") #=> 0 File.stat("testfile").size ...

يتحقق التابع zero?‎ إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). البنية العامة zero?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). خلا ذلك، تعاد القيمة false. انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. ...

يتحقق التابع owned?‎ إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. البنية العامة owned?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية الحالية. خلا ذلك، تعاد القيمة false. انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير ...

يتحقق التابع owned?‎ إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية التي استدعته. البنية العامة owned?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما موجودًا وكان مالك هذا الملف هو نفسه المعرِّف الفعلي للمستخدم المالك للعملية الحالية. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable_real?‎: يتحقق ...

يتحقق التابع file?‎ إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. البنية العامة file?(file) → true or false المعاملات file سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file موجودًا وكان ملفًا طبيعيًّا. خلا ذلك، تعاد القيمة false.  انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع zero?‎: يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). التابع executable?‎: يتحقق ...

يتحقق التابع zero?‎ إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). البنية العامة zero?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name  موجودًا وخاويًا (صفر الحجم). خلا ذلك، تعاد القيمة false. انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم ...

يعيد التابع stat كائنًا من النوع File::Stat للملف المحدَّد. اطلع على توثيق الصنف File::Stat لمزيد من المعلومات. البنية العامة stat(file_name) → stat المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف الذي ستُطبَّق عليه العملية. القيمة المعادة يعاد كائنٌ من النوع File::Stat للملف file_name. أمثلة مثال على استعمال التابع stat: File.stat("testfile").mtime #=> Tue Apr 08 12:58:04 CDT 2003 انظر أيضا التابع lstat: يشبه التابع stat باستثناء أنَّه لا يتبع الوصلات الرمزية (أي أنَّه يعيد كائنًا من ...

يتحقق التابع zero?‎ إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). البنية العامة zero?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name  موجودًا وخاويًا (صفر الحجم). خلا ذلك، تعاد القيمةfalse. انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع executable_real?‎: يتحقق إن كان ...

يتحقق التابع directory?‎ إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. البنية العامة directory?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون كائنًا من النوع IO. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع directory?‎: File.directory?(".") انظر أيضا التابع zero?‎: يتحقق إن كان ملفٌ ما موجودًا وخاويًا (صفر الحجم). التابع executable?‎: يتحقق إن كان ...

يتحقق التابع world_writable?‎ إن كان ملفٌ ما قابلًا للكتابة من طرف الآخرين. البنية العامة world_writable?(file_name) → integer or nil المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون هذا المعامل كائنًا من النوع IO. القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف file_name إن كان قابلًا للكتابة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالة stat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_writable?‎: File.world_writable?("/tmp") ...

يتحقق التابع exist?‎ إن كان ملفٌ ما موجودًا. "الملف موجود" يعني أنه نجح استدعاء دالتي النظام stat()‎ و fstat()‎. البنية العامة exist?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name موجودًا. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع executable_real?‎: يتحقق إن كان ...

يعيد التابع superclass الصنف الأب (superclass) للصنف المستدعى معه. البنية العامة superclass → a_super_class or nil القيمة المعادة يعاد الصنف الأب للصنف المعطى أو القيمة nil إن لم يكن للصنف المعطى صنف أب. أمثلة مثال على استخدام التابع superclass: File.superclass #=> IO IO.superclass #=> Object Object.superclass #=> BasicObject class Foo; end class Bar < Foo; end Bar.superclass ...

يتحقق التابع world_writable?‎ إن كان ملفٌ ما قابلًا للكتابة من طرف الآخرين. البنية العامة world_writable?(file_name) → integer or nil المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون هذا المعامل كائنًا من النوع IO. القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف file_name إن كان قابلًا للكتابة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالة stat(2)‎ في المنصات الشبيهة بيونكس.  أمثلة مثال على استعمال التابع world_writable?‎: File.world_writable?("/tmp") ...

يتحقق التابع directory?‎ إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. البنية العامة directory?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. خلا ذلك، تعاد القيمة false. أمثلة مثال على استعمال التابع directory?‎: File.directory?(".") انظر أيضًا التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. التابع executable_real?‎: يتحقق إن كان ...

يعيد التابع ctime وقت آخر تغيير أجري على ملف محدَّد. يشير وقت التغيير هذا إلى الزمن الذي تغيرت فيه معلومات المجلد حول الملف وليس الملف نفسه. البنية العامة ctime(file_name) → time المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل اسم الملف المراد معرفة وقت آخر تغيير جرى له. القيمة المعادة يعاد كائن من النوع Time يمثِّل وقت آخر تغيير جرى للمعلومات حول الملف file_name. في أنظمة ويندوز (أي أنظمة الملفات NTFS)، يعاد وقت إنشاء الملف وليس وقت التغيير. أمثلة ...

يتحقق التابع grpowned?‎ إن كان ملفٌ ما موجودًا وكان معرِّف المجموعة المالكة الفعلي للعملية التي استدعت التابع هو مالك هذا الملف. البنية العامة grpowned?(file_name) → true or false المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون كائنًا من النوع IO. القيمة المعادة تعاد القيمة true إن كان ملفٌ ما موجودًا وكان معرِّف المجموعة المالكة الفعلي للعملية التي استدعت التابع هو مالك هذا الملف. خلا ذلك، تعاد القيمة false. تعاد القيمة false دومًا على أنظمة ويندوز. أمثلة مثال على استعمال التابع grpowned?‎: انظر أيضًا التابع blockdev?‎: ...

يتحقق التابع exist?‎ إن كان ملفٌ ما موجودًا. "الملف موجود" يعني أنه نجح استدعاء دالتي النظام stat()‎ و fstat()‎. البنية العامة exist?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name موجودًا. خلا ذلك، تعاد القيمة false. انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع zero?‎: يتحقق إن كان ملفٌ ما موجودًا وخاويًا ...

يجلب التابع getc المحرف التالي من المجرى ARGF. يعامل المجرى ARGF الملفات المُمرَّرة في سطر الأوامر كما لو كانت ملفًا واحدًا يتألَّف من جميع تلك الملفات؛ أي يتعاقب بعضها خلف بعض. بناءً على ذلك، يؤدي استدعاء التابع getc مرة أخرى بعد جلب المحرف الأخير من الملف الأول مثلًا إلى جلب المحرف الأول من الملف الثاني، وهلم جرًّا. البنية العامة getc → String or nil القيم المعادة تعاد سلسلة نصية تحوي المحرف التالي الذي يُقرَأ من المجرى ARGF، أو تعاد القيمة ...

يعيد التابع raw_data مصفوفة من الأنواع Hash تحوي بيانات ملفات التعريف الأولية الفردية مُرتَّبة من الأقدم إلى الأحدث بواسطة ‎:GC_INVOKE_TIME. إليك مثلًا الشيفرة التالية: [ { :GC_TIME=>1.3000000000000858e-05, :GC_INVOKE_TIME=>0.010634999999999999, :HEAP_USE_SIZE=>289640, :HEAP_TOTAL_SIZE=>588960, :HEAP_TOTAL_OBJECTS=>14724, :GC_IS_MARKED=>false }, # ... ] وتعني المفاتيح الموجودة في الشيفرة ما يلي: ‎:GC_TIME: الوقت Time المنقضي بالثواني لتشغيل GC هذا. ‎:GC_INVOKE_TIME: الوقت Time المنقضي بالثواني ...

يقرأ التابع readchar المحرف التالي من المجرى ARGF ثم يعيده على شكل سلسلة نصية. يُطلِق التابع الخطأ EOFError بعد قراءة المحرف الأخير من الملف الأخير. البنية العامة readchar → String or nil القيمة المعادة تعاد سلسلة نصية تحوي المحرف الذي قُرِأ من المجرى ARGF أمثلة مثال لاستخدام التابع readchar: $ echo "foo" > file $ ruby argf.rb file ARGF.readchar #=> "f" ARGF.readchar #=> "o" ARGF.readchar #=> "o" ARGF.readchar #=> "\n" ARGF.readchar #=> end of file reached (EOFError) انظر أيضًا التابع read: ...

يتحقق التابع executable_real?‎ إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الحقيقي للمستخدم المالك والمجموعة المالكة للعملية الحالية. اطلع أيضًا على توثيق الدالة access(3)‎. البنية العامة executable_real?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name قابلًا للتنفيذ من طرف المعرِّف الحقيقي للمستخدم المالك والمجموعة المالكة للعملية الحالية. خلا ذلك، تعاد القيمة false.   انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن ...

يعيد التابع fileno عددًا صحيحًا يمثل واصف الملف العددي (numeric file descriptor) للملف الحالي. إن لم يكن هنالك ملف، فسيُطلَق الخطأ ArgumentError. البنية العامة fileno → integer القيم المعادة يعاد عدد صحيح (integer) يمثل واصف الملف الرقمي (numeric file descriptor) للملف الحالي. أمثلة مثالٌ على استخدام التابع fileno: ARGF.fileno #=> 3 انظر أيضًا التابع file: يعيد الملف الحالي على شكل كائن من النوع IO أو File. التابع filename: يعيد اسم الملف الحالي. التابع lineno: يجلب ...

يتحقق التابع file?‎ إن كان ملفٌ ما موجودًا وكان ملفًا طبيعيًّا. البنية العامة file?(file) → true or false المعاملات file سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. إن كان هذا المعامل وصلةً رمزيَّةً، فستُتبَع هذه الوصلة ويُستعمَل الملف الذي تشير إليه. القيمة المعادة تعاد القيمة true إن كان الملف file موجودًا وكان ملفًا طبيعيًّا. خلا ذلك، تعاد القيمة false.  انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع executable?‎: يتحقق إن كان ملفٌ ما قابلًا للتنفيذ من ...

يتحقق التابع executable_real?‎ إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الحقيقي للمستخدم المالك والمجموعة المالكة للعملية الحالية. اطلع أيضًا على توثيق الدالة access(3)‎. البنية العامة executable_real?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name قابلًا للتنفيذ من طرف المعرِّف الحقيقي للمستخدم المالك والمجموعة المالكة للعملية الحالية. خلا ذلك، تعاد القيمة false.   انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ...

يتحقق التابع world_readable?‎ إن كان ملفٌ ما قابلًا للقراءة من طرف الآخرين. البنية العامة world_readable?(file_name) → integer or nil المعاملات file_name اسم الملف المراد التحقق منه. يمكن أن يكون هذا المعامل كائنًا من النوع IO. القيمة المعادة يعاد عدد صحيح يمثِّل بتات أذونات الملف file_name إن كان قابلًا للقراءة من طرف الآخرين. خلا ذلك، تعاد القيمة nil. تعتمد بتات الأذونات المعادة على المنصة المستعملة. اطلع على الدالة stat(2)‎ في المنصات الشبيهة بيونكس. أمثلة مثال على استعمال التابع world_readable?‎: File.world_readable?("/etc/passwd") ...

يوفر مُنشئ ملفات تعريف جمع البيانات المهملة GC::Profiler الوصول إلى معلومات عن تشغيلات GC بما في ذلك الوقت والطول وحجم مساحة الكائن. اطلع مثلًا على المثال التالي: GC::Profiler.enable require 'rdoc/rdoc' GC::Profiler.report GC::Profiler.disable اطلع أيضًا على صفحات التوابع GC.count و GC.malloc_allocated_size و GC.malloc_allocations. توابع الصنف العام clear يمسح بيانات مُنشئ ملفات تعريف GC. disable يوقف مُنشئ ملفات تعريف GC. enable يبدأ منشئ ملفات تعريف GC. enabled?‎ يتحقق من الحالة الحالية لوضع مُنشئ ملفات تعريف GC. raw_data يعيد مصفوفة من الأنواع Hash تحوي بيانات ملفات التعريف الأولية الفردية مُرتَّبة من الأقدم إلى ...

يتحقق التابع executable?‎ إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. اطلع أيضًا على توثيق الدالة eaccess(3)‎. البنية العامة executable?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يمثِّل الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. خلا ذلك، تعاد القيمة false.  انظر أيضًا التابع directory?‎: يتحقق إن كان ملفٌ ما مجلَّدًا أو وصلةً رمزيًّةً تشير إلى مجلدٍ. التابع zero?‎: يتحقق إن ...

يعيد التابع list قائمة بأسماء الإشارة المعيَّنة لأرقام الإشارة الأصلية المقابلة لها. البنية العامة list → a_hash‎ القيمة المعادة يعاد كائن من النوع Hash يمثِّل قائمة بأسماء الإشارة المسندة لأرقام الإشارة الأصلية المقابلة لها. أمثلة مثال على استخدام التابع list‎: Signal.list #=> {"EXIT"=>0, "HUP"=>1, "INT"=>2, "QUIT"=>3, "ILL"=>4, "TRAP"=>5, "IOT"=>6, "ABRT"=>6, "FPE"=>8, "KILL"=>9, "BUS"=>7, "SEGV"=>11, "SYS"=>31, "PIPE"=>13, "ALRM"=>14, "TERM"=>15, "URG"=>23, "STOP"=>19, "TSTP"=>20, "CONT"=>18, "CHLD"=>17, "CLD"=>17, "TTIN"=>21, "TTOU"=>22, "IO"=>29, "XCPU"=>24, "XFSZ"=>25, "VTALRM"=>26, "PROF"=>27, "WINCH"=>28, "USR1"=>10, "USR2"=>12, "PWR"=>30, "POLL"=>29}‎ انظر أيضًا التابع signame: ...

يستدعي التابع each_byte الكتلة المعطاة على كل بايت (0..255) في المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة each_byte {|byte| block } → ios each_byte→ an_enumerator‎ القيمة المعادة يعاد المجرى المعطى بعد تنفيذ الكتلة block على كل بايت من بايتاته، أو يعاد كائن من الصنف Enumerator في حال لم تُعطَ أية كتلة. أمثلة مثال على استخدام التابع ...

يتحقق التابع executable?‎ إن كان ملفٌ ما قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. اطلع أيضًا على توثيق الدالة eaccess(3)‎. البنية العامة executable?(file_name) → true or false المعاملات file_name سلسلة نصية أو كائن من النوع IO يحدِّد اسم الملف المراد التحقق منه. القيمة المعادة تعاد القيمة true إن كان الملف file_name قابلًا للتنفيذ من طرف المعرِّف الفعلي للمستخدم المالك والمجموعة المالكة للعملية الحالية. خلا ذلك، تعاد القيمة false.  انظر أيضا التابع directory?‎: يتحقق إن كان ملفٌ ...

يستدعي التابع each_char الكتلة المعطاة على كل محرف في المجرى الذي استدعي معه. يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة each_char {|c| block } → ios each_char→ an_enumerator‎ القيمة المعادة يعاد المجرى المعطى بعد تنفيذ الكتلة block على كل محرف من محارفه، أو يعاد كائن من الصنف Enumerator في حال لم تُعطَ أية كتلة.  أمثلة مثال على استخدام التابع each_char‎: ...

ما هي تقنية Kotlin/Native؟ تُستخدَم تقنية Kotlin/Native لترجمة شيفرات Kotlin إلى الصيغة الثنائيّة الأساسيّة (native binaries) والتي لا تتطلَّب آلةً افتراضيّة (virtual machine) لتشغيلها، وتشمل كلًا من المعالجات الخلفيّة (أو السند الخلفي [backend]) المعتمدة على تقنيات مكتبة LLVM للمترجِم (compiler) وكذلك تعريف الاستخدام الأساسيّ (native implementation) من مكتبة التشغيل (runtime) في Kotlin، وقد صُمّمت هذه التقنية للسماح بالترجمة في منصّات العمل التي تكون فيها الآلات الافتراضيّة غير متاحةٍ أو مرغوبةٍ (مثل أنظمة iOS والأهداف المدمجة [embedded targets])، أو عندما يحتاج ...

تُستخدَم إضافة اتجاه الشاشة (cordova-plugin-screen-orientation) للتحكم باتجاه الشاشة (عبر ضبطها إلى اتجاه محدَّد أو منع تغيير الاتجاه) بشكل موحَّد في المنصات iOS وأندرويد و windows-uwp. تعتمد هذه الإضافة على الواجهة البرمجية لاتجاه الشاشة، حتى تتطابق مع المواصفات الحالية. تضيف هذه الإضافة العناصر التالية إلى كائن الشاشة window.screen: // منع تغيير اتجاه الشاشة .orientation.lock('portrait') // السماح بتغيير اتجاه الشاشة .orientation.unlock() // الاتجاه الحالي .orientation‎ التثبيت يمكن تثبيت هذه الإضافة عبر الأمر التالي: cordova plugin add cordova-plugin-screen-orientation‎ الاتجاهات المدعومة portrait-primary يمثل هذا الاتجاه الوضع العمودي الأولي (primary ...

تحوّل المكتبة Marshal مجموعات من كائنات روبي إلى مجرى من البايتات (byte stream)، مما يسمح بتخزينها خارج البرنامج النصي النشط حاليًا. يمكن بعد ذلك قراءة تلك البيانات وإعادة إنشاء الكائنات الأصلية أنشئت منها. تحتوي البيانات المرصوفة (Marshaled data) على أرقام الإصدار الرئيسية والثانوية مخزنةً مع معلومات الكائن. في الاستخدام العادي، تُحمّل فقط البيانات التي لها نفس رقم الإصدار الرئيسي، ورقم الإصدار الثانوي المساوي أو الأقل منه. وفي حال ضبط قيمة الراية "verbose" (عادةً باستخادم ‎-d أو ‎-v أو ‎-w أو ...