نتائج البحث

الصنف 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 #=> ...