InputStream الفصل

كائن يشبه الملف يمثل كائنا ثنائيا كبير الحجم للإدخل.

توريث
InputStream
InputStream

الدالمنشئ

InputStream()

الأساليب

close

امسح كائن IO وأغلقه.

لا يكون لهذا الأسلوب أي تأثير إذا كان الملف مغلقا بالفعل.

detach

افصل هذا المخزن المؤقت عن الدفق الأولي الأساسي الخاص به وأرجعه.

بعد فصل الدفق الخام، يكون المخزن المؤقت في حالة غير قابلة للاستخدام.

fileno

إرجاع واصف الملف الأساسي إذا كان موجودا.

يتم رفع OSError إذا كان عنصر IO لا يستخدم واصف ملف.

flush

مسح المخازن المؤقتة للكتابة، إن أمكن.

لا يتم تنفيذ هذا للتدفقات للقراءة فقط وغير المحظورة.

isatty

إرجاع ما إذا كان هذا دفق "تفاعلي".

إرجاع False إذا تعذر تحديده.

read

إرجاع وحدات البايت والقراءة حتى حجمها .

read1

اقرأ وارجع ما يصل إلى n بايت، مع استدعاء واحد للقراءة() على الأكثر إلى الدفق الأولي الأساسي. لا تعني النتيجة القصيرة أن EOF وشيك.

إرجاع كائن بايت فارغ على EOF.

readable

إرجاع ما إذا كان الكائن قد تم فتحه للقراءة.

إذا كانت False، فسيؤدي read() إلى رفع OSError.

readinto
readinto1
readline

قراءة سطر وإرجاعه من الدفق.

إذا تم تحديد الحجم، فستتم قراءة وحدات البايت بالحجم على الأكثر.

فاصل السطر هو دائما b'n' للملفات الثنائية؛ بالنسبة للملفات النصية، يمكن استخدام وسيطة الخطوط الجديدة لفتحها لتحديد فاصل الأسطر الذي تم التعرف عليه.

readlines

إرجاع قائمة الأسطر من الدفق.

يمكن تحديد تلميح للتحكم في عدد الأسطر المقروءة: لن تتم قراءة المزيد من الأسطر إذا تجاوز الحجم الإجمالي (بالبايت/الأحرف) لجميع الأسطر حتى الآن التلميح.

seek

تغيير موضع الدفق.

قم بتغيير موضع الدفق إلى إزاحة البايت المحددة. يتم تفسير الإزاحة بالنسبة للموضع المشار إليه بواسطة whence. قيم whence هي:

  • 0 - بداية الدفق (الافتراضي)؛ يجب أن تكون الإزاحة صفرا أو موجبا

  • 1 - موضع الدفق الحالي؛ قد تكون الإزاحة سالبة

  • 2 - نهاية الدفق؛ الإزاحة عادة ما تكون سالبة

إرجاع الموضع المطلق الجديد.

seekable

إرجاع ما إذا كان العنصر يدعم الوصول العشوائي.

إذا كانت False، فإن seek() و tell() وtruncate() سترفع OSError. قد تحتاج هذه الطريقة إلى إجراء بحث اختبار().

tell

إرجاع موضع الدفق الحالي.

truncate

اقتطاع الملف إلى بايت الحجم.

لم يتم ترك مؤشر الملف دون تغيير. الحجم الافتراضي لموضع IO الحالي كما تم الإبلاغ عنه بواسطة tell(). إرجاع الحجم الجديد.

writable

إرجاع ما إذا كان الكائن قد تم فتحه للكتابة.

إذا كانت False، فسيؤدي write() إلى رفع OSError.

write

اكتب المخزن المؤقت المحدد إلى دفق IO.

إرجاع عدد وحدات البايت المكتوبة، وهو طول b بالبايت دائما.

يرفع BlockingIOError إذا كان المخزن المؤقت ممتلئا ولا يمكن للتدفق الأولي الأساسي قبول المزيد من البيانات في الوقت الحالي.

writelines

اكتب قائمة الأسطر للبث.

لا تتم إضافة فواصل الأسطر، لذلك من المعتاد أن يكون لكل سطر من الأسطر المتوفرة فاصل أسطر في النهاية.

close

امسح كائن IO وأغلقه.

لا يكون لهذا الأسلوب أي تأثير إذا كان الملف مغلقا بالفعل.

close()

detach

افصل هذا المخزن المؤقت عن الدفق الأولي الأساسي الخاص به وأرجعه.

بعد فصل الدفق الخام، يكون المخزن المؤقت في حالة غير قابلة للاستخدام.

detach()

fileno

إرجاع واصف الملف الأساسي إذا كان موجودا.

يتم رفع OSError إذا كان عنصر IO لا يستخدم واصف ملف.

fileno()

flush

مسح المخازن المؤقتة للكتابة، إن أمكن.

لا يتم تنفيذ هذا للتدفقات للقراءة فقط وغير المحظورة.

flush()

isatty

إرجاع ما إذا كان هذا دفق "تفاعلي".

إرجاع False إذا تعذر تحديده.

isatty()

read

إرجاع وحدات البايت والقراءة حتى حجمها .

abstract read(size=-1) -> bytes

المعلمات

size
int
القيمة الافتراضية: -1

عدد وحدات البايت المراد قراءتها. إذا تم حذف الوسيطة أو Noneأو سالبة، تتم قراءة البيانات وإرجاعها حتى يتم الوصول إلى EOF.

المرتجعات

وحدات البايت المقروءة من دفق الإدخال.

read1

اقرأ وارجع ما يصل إلى n بايت، مع استدعاء واحد للقراءة() على الأكثر إلى الدفق الأولي الأساسي. لا تعني النتيجة القصيرة أن EOF وشيك.

إرجاع كائن بايت فارغ على EOF.

read1()

readable

إرجاع ما إذا كان الكائن قد تم فتحه للقراءة.

إذا كانت False، فسيؤدي read() إلى رفع OSError.

readable()

readinto

readinto(buffer, /)

المعلمات

buffer
مطلوب

readinto1

readinto1(buffer, /)

المعلمات

buffer
مطلوب

readline

قراءة سطر وإرجاعه من الدفق.

إذا تم تحديد الحجم، فستتم قراءة وحدات البايت بالحجم على الأكثر.

فاصل السطر هو دائما b'n' للملفات الثنائية؛ بالنسبة للملفات النصية، يمكن استخدام وسيطة الخطوط الجديدة لفتحها لتحديد فاصل الأسطر الذي تم التعرف عليه.

readline(size=-1, /)

المعلمات

size
القيمة الافتراضية: -1

readlines

إرجاع قائمة الأسطر من الدفق.

يمكن تحديد تلميح للتحكم في عدد الأسطر المقروءة: لن تتم قراءة المزيد من الأسطر إذا تجاوز الحجم الإجمالي (بالبايت/الأحرف) لجميع الأسطر حتى الآن التلميح.

readlines(hint=-1, /)

المعلمات

hint
القيمة الافتراضية: -1

seek

تغيير موضع الدفق.

قم بتغيير موضع الدفق إلى إزاحة البايت المحددة. يتم تفسير الإزاحة بالنسبة للموضع المشار إليه بواسطة whence. قيم whence هي:

  • 0 - بداية الدفق (الافتراضي)؛ يجب أن تكون الإزاحة صفرا أو موجبا

  • 1 - موضع الدفق الحالي؛ قد تكون الإزاحة سالبة

  • 2 - نهاية الدفق؛ الإزاحة عادة ما تكون سالبة

إرجاع الموضع المطلق الجديد.

seek()

seekable

إرجاع ما إذا كان العنصر يدعم الوصول العشوائي.

إذا كانت False، فإن seek() و tell() وtruncate() سترفع OSError. قد تحتاج هذه الطريقة إلى إجراء بحث اختبار().

seekable()

tell

إرجاع موضع الدفق الحالي.

tell()

truncate

اقتطاع الملف إلى بايت الحجم.

لم يتم ترك مؤشر الملف دون تغيير. الحجم الافتراضي لموضع IO الحالي كما تم الإبلاغ عنه بواسطة tell(). إرجاع الحجم الجديد.

truncate()

writable

إرجاع ما إذا كان الكائن قد تم فتحه للكتابة.

إذا كانت False، فسيؤدي write() إلى رفع OSError.

writable()

write

اكتب المخزن المؤقت المحدد إلى دفق IO.

إرجاع عدد وحدات البايت المكتوبة، وهو طول b بالبايت دائما.

يرفع BlockingIOError إذا كان المخزن المؤقت ممتلئا ولا يمكن للتدفق الأولي الأساسي قبول المزيد من البيانات في الوقت الحالي.

write()

writelines

اكتب قائمة الأسطر للبث.

لا تتم إضافة فواصل الأسطر، لذلك من المعتاد أن يكون لكل سطر من الأسطر المتوفرة فاصل أسطر في النهاية.

writelines(lines, /)

المعلمات

lines
مطلوب

السمات

closed

length

name

uri