التابع array.fromfile()‎ في بايثون

يقرأ التابع العدد المعطى من العناصر (كقيم جهاز machine values) من كائن الملف المعطى ويلحقها بنهاية المصفوفة.

البنية العامة

‎array.fromfile(f, n)

المعاملات

f

كائن الملف الذي يقرأ التابع عناصره ويضيفها إلى المصفوفة.

يجب أن يكون f كائن ملف داخلي حقيقي، ولا يجدي نفعًا استخدام شيء آخر يمتلك التابع read()‎.

n

عدد العناصر المقروءة من كائن الملف.

إن كان عدد العناصر المتوفّرة أقلّ من n، تطلق اللغة الخطأ EOFError، ومع ذلك تدرج القيم المتوفّرة في نهاية المصفوفة.

القيمة المعادة

يعيد التابع القيمة None.

أمثلة

يبين المثال التالي آلية عمل التابع (يفترض المثال التالي وجود ملف نصي يحمل الاسم f1.txt ويتضمن بعض النصوص):

>>> import array
>>> f = open('f1.txt', 'rb')
>>> a1 = array.array('b')
>>> a1.fromfile(f, 2)
>>> a1
array('b', [80, 121])
>>> a1.fromfile(f, 20)
>>> a1
array('b', [80, 121, 116, 104, 111, 110, 10, 68, 106, 97, 110, 103, 111, 10, 70, 108, 97, 115, 107, 10, 78, 117])

انظر أيضًا

• التابع array.frombytes()‎: يلحق التابع عناصر السلسلة النصية المعطاة وذلك بتفسير السلسلة النصية كمصفوفة من قيم الجهاز machine values (كما لو أنّها مقروءة من ملف باستخدام التابع fromfile()‎).
• التابع array.fromlist()‎: يلحق التابع عناصر القائمة المعطاة بالمصفوفة.
• التابع array.fromunicode()‎: يوسع التابع المصفوفة بإضافة البيانات من السلسلة النصية المرمّزة بترميز Unicode.

مصادر

صفحة Efficient arrays of numeric values في توثيق بايثون الرسمي.