نتائج البحث

يحرِّك التابع 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 في توثيق روبي الرسمي.