التابع copy_stream الخاص بالصنف IO في روبي
ينسخ التابع copy_stream المصدر المعطى src في المورد dst (انظر فقرة البنية العامة). الوسيطان src و dst يمكن أن يكونا اسماء ملفات، أو كائنات مشابهة للصنف IO.
الكائنات المشابهة لـ IO المُمررة في الوسيط src يجب أن تُعرّف التابع readpartial أو read. كما يجب أن يكون للكائنات المشابهة لـ IO الممررة في الوسيط dst التابع write. (في بعض الحالات، يمكن استخدام آليات خاصة، مثل استدعاء النظام sendfile)
يُعيد هذا التابع عدد البايتات المنسوخة.
في حال عدم إعطاء الوسائط الاختيارية، فإن موضع بدء النسخ سيكون هو بداية الملف، أو موضع الإزاحة (offset) الحالي في ملف المجرى د/خ المستقبِل. أما موضع نهاية النسخ فسيكون عند نهاية الملف.
في حال إعطاء الوسيط copy_length، فلن يتجاوز عدد البايتات المنسوخة القيمة copy_length.
يحدد الوسيط src_offset، في حال إعطائه، موضع بدء النسخ.
عند تحديد src_offset، وعندما يكون الوسيط src عبارة عن مجرى د/خ، فلن يحرك التابع copy_stream موضع إزاحة الملف الحالي.
البنية العامة
copy_stream(src, dst)
copy_stream(src, dst, copy_length)
copy_stream(src, dst, copy_length, src_offset)
المعاملات
src
المصدر.
dst
المورد.
copy_length
طول النسخ.
src_offset
الإزاحة.
انظر أيضا
- التابع
binwrite: التابعbinwriteمشابه للتابعIO.write، ما عدا أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT.