الفرق بين المراجعتين لصفحة: «Python/ZipInfo»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الصنف <code>ZipInfo</code> في بايثون}}</noinclude> يستخدم هذا الصنف لعرض المعلومات الخاصّ...' |
|||
(5 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الصنف <code>ZipInfo</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الصنف <code>ZipInfo</code> في بايثون}}</noinclude> | ||
يستخدم هذا الصنف لعرض المعلومات الخاصّة بعضو من أعضاء ملف الأرشيف. يعيد التابعان getinfo() و infolist() في كائنات ZipFile نسخًا من هذا الصنف. لن تحتاج في أغلب الأحيان إلى إنشاء نسخة من هذا الصنف بنفسك، بل ستستخدم النسخ التي تنشئها الوحدة zipfile. | يستخدم هذا الصنف لعرض المعلومات الخاصّة بعضو من أعضاء ملف الأرشيف. يعيد التابعان <code>[[Python/ZipFile/getinfo|getinfo()]]</code> و <code>[[Python/ZipFile/infolist|infolist()]]</code> في كائنات <code>[[Python/ZipFile|ZipFile]]</code> نسخًا من هذا الصنف. لن تحتاج في أغلب الأحيان إلى إنشاء نسخة من هذا الصنف بنفسك، بل ستستخدم النسخ التي تنشئها الوحدة <code>[[Python/zipfile|zipfile]]</code>. | ||
== البنية العامة == | == البنية العامة == | ||
سطر 11: | سطر 11: | ||
== المعاملات == | == المعاملات == | ||
=== filename === | === <code>filename</code> === | ||
الاسم الكامل لعضو الأرشيف. | الاسم الكامل لعضو الأرشيف. | ||
=== date_time === | === <code>date_time</code> === | ||
يجب أن يكون هذا المعامل صفًّا يتضمن ستة حقول تمثّل الوقت الذي جرى فيه آخر تعديل للملف. راجع قسم | يجب أن يكون هذا المعامل [[Python/tuples|صفًّا]] يتضمن ستة حقول تمثّل الوقت الذي جرى فيه آخر تعديل للملف. راجع قسم خصائص <code>ZipInfo</code> للاطلاع على وصف مفصّل لهذه الحقول. | ||
'''ملاحظات:''' | '''ملاحظات:''' | ||
سطر 25: | سطر 25: | ||
== خصائص الصنف <code>ZipInfo</code> == | == خصائص الصنف <code>ZipInfo</code> == | ||
=== ZipInfo.filename === | === <code>ZipInfo.filename</code> === | ||
اسم الملف في الأرشيف. | اسم الملف في الأرشيف. | ||
=== ZipInfo.date_time === | === <code>ZipInfo.date_time</code> === | ||
تاريخ وزمن آخر تعديل أجري على العضو في الأرشيف. هذه الخاصية عبارة عن صفّ يحتوي على ستّ قيم: | تاريخ وزمن آخر تعديل أجري على العضو في الأرشيف. هذه الخاصية عبارة عن [[Python/tuples|صفّ]] يحتوي على ستّ قيم: | ||
{| class="wikitable" | |||
!التسلسل | |||
0 | !القيمة | ||
|- | |||
1 | |0 | ||
|السنة (>= 1980) | |||
2 | |- | ||
|1 | |||
3 | |الشهر (يبدأ من 1) | ||
|- | |||
4 | |2 | ||
|اليوم في الشهر (يبدأ من 1) | |||
5 | |- | ||
|3 | |||
|الساعات (تبدأ من 0) | |||
|- | |||
|4 | |||
|الدقائق (تبدأ من 0) | |||
|- | |||
|5 | |||
|الثواني (تبدأ من 0) | |||
|} | |||
'''ملاحظة:''' لا تدعم ملفات ZIP الأختام الزمنية التي تسبق التاريخ 1980. | |||
=== <code>ZipInfo.compress_type</code> === | |||
=== ZipInfo.compress_type === | |||
نوع عملية الضغط المطبّقة على العضو في الأرشيف. | نوع عملية الضغط المطبّقة على العضو في الأرشيف. | ||
=== ZipInfo.comment === | === <code>ZipInfo.comment</code> === | ||
التعليق المرتبط بالعضو في الأرشيف. | التعليق المرتبط بالعضو في الأرشيف. | ||
=== ZipInfo.extra === | === <code>ZipInfo.extra</code> === | ||
بيانات Expansion field. تحتوي الملاحظات الخاصة بتطبيق PKZIP على بعض التوضيحات بخصوص البنية الداخلية للبيانات التي تتضمّنها هذه السلسلة النصية. | بيانات Expansion field. تحتوي الملاحظات الخاصة بتطبيق PKZIP على بعض التوضيحات بخصوص البنية الداخلية للبيانات التي تتضمّنها هذه السلسلة النصية. | ||
=== ZipInfo.create_system === | === <code>ZipInfo.create_system</code> === | ||
النظام الذي أنشأ ملف ZIP. | النظام الذي أنشأ ملف ZIP. | ||
=== ZipInfo.create_version === | === <code>ZipInfo.create_version</code> === | ||
إصدار تطبيق PKZIP الذي أنشأ ملف ZIP. | إصدار تطبيق PKZIP الذي أنشأ ملف ZIP. | ||
=== ZipInfo.extract_version === | === <code>ZipInfo.extract_version</code> === | ||
إصدار تطبيق PKZIP الواجب استخدامه لاستخراج الملفات من ملف ZIP. | إصدار تطبيق PKZIP الواجب استخدامه لاستخراج الملفات من ملف ZIP. | ||
=== ZipInfo.reserved === | === <code>ZipInfo.reserved</code> === | ||
يجب أن تكون صفرًا. | يجب أن تكون صفرًا. | ||
=== ZipInfo.flag_bits === | === <code>ZipInfo.flag_bits</code> === | ||
رايات البتات flag bits الخاصّة بملف ZIP. | رايات البتات flag bits الخاصّة بملف ZIP. | ||
=== ZipInfo.volume === | === <code>ZipInfo.volume</code> === | ||
رقم الإصدار volume لترويسة الملف. | رقم الإصدار volume لترويسة الملف. | ||
=== ZipInfo.internal_attr === | === <code>ZipInfo.internal_attr</code> === | ||
الخصائص الداخلية. | الخصائص الداخلية. | ||
=== ZipInfo.external_attr === | === <code>ZipInfo.external_attr</code> === | ||
الخصائص الخارجية للملف. | الخصائص الخارجية للملف. | ||
=== ZipInfo.header_offset === | === <code>ZipInfo.header_offset</code> === | ||
مقدار الإزاحة بالبايتات إلى ترويسة الملف. | مقدار الإزاحة بالبايتات إلى ترويسة الملف. | ||
=== ZipInfo.CRC === | === <code>ZipInfo.CRC</code> === | ||
CRC-32 للملفات غير المضغوطة. | CRC-32 للملفات غير المضغوطة. | ||
=== ZipInfo.compress_size === | === <code>ZipInfo.compress_size</code> === | ||
حجم البيانات المضغوطة. | حجم البيانات المضغوطة. | ||
=== ZipInfo.file_size === | === <code>ZipInfo.file_size</code> === | ||
حجم الملفات غير المضغوطة. | حجم الملفات غير المضغوطة. | ||
سطر 105: | سطر 112: | ||
== توابع الصنف <code>ZipInfo</code> == | == توابع الصنف <code>ZipInfo</code> == | ||
=== تابع الصنف ZipInfo. | === تابع الصنف <code>[[Python/ZipInfo/from file|ZipInfo.from_file()]]</code> === | ||
ينشئ تابع الصنف هذا كائن <code> | ينشئ تابع الصنف هذا كائن <code>ZipInfo</code> للملف المعطى، ويهيّئه لإضافته إلى ملف zip. | ||
=== التابع ZipInfo.is_dir() === | === التابع <code>[[Python/ZipInfo/is dir|ZipInfo.is_dir()]]</code> === | ||
يتحقّق التابع ممّا إذا كان عضو الأرشيف مجلّدًا folder أم لا. | يتحقّق التابع ممّا إذا كان عضو الأرشيف مجلّدًا folder أم لا. | ||
سطر 124: | سطر 131: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الصنف <code>[[Python/ZipFile|ZipFile]]</code>: يستخدم هذا الصنف لقراءة ملفات ZIP والكتابة فيها. | * الصنف <code>[[Python/ZipFile|ZipFile]]</code>: يستخدم هذا الصنف لقراءة ملفات ZIP والكتابة فيها. | ||
* الصنف <code>[[Python/ | * الصنف <code>[[Python/PyZipFile|PyZipFile]]</code>: يستخدم هذا الصنف لإنشاء ملفات ZIP تتضمّن مكتبات بايثون. | ||
== مصادر == | == مصادر == | ||
* [https://docs.python.org/3/library/zipfile.html#zipfile. | * [https://docs.python.org/3/library/zipfile.html#zipfile.ZipInfo صفحة Work with ZIP archives في توثيق بايثون الرسمي.] | ||
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Modules]] | [[تصنيف:Python Modules]] |
المراجعة الحالية بتاريخ 11:39، 16 نوفمبر 2018
يستخدم هذا الصنف لعرض المعلومات الخاصّة بعضو من أعضاء ملف الأرشيف. يعيد التابعان getinfo()
و infolist()
في كائنات ZipFile
نسخًا من هذا الصنف. لن تحتاج في أغلب الأحيان إلى إنشاء نسخة من هذا الصنف بنفسك، بل ستستخدم النسخ التي تنشئها الوحدة zipfile
.
البنية العامة
class zipfile.ZipInfo(filename='NoName', date_time=(1980, 1, 1, 0, 0, 0))
المعاملات
filename
الاسم الكامل لعضو الأرشيف.
date_time
يجب أن يكون هذا المعامل صفًّا يتضمن ستة حقول تمثّل الوقت الذي جرى فيه آخر تعديل للملف. راجع قسم خصائص ZipInfo
للاطلاع على وصف مفصّل لهذه الحقول.
ملاحظات:
- هذا الكائن جديد في الإصدار 3.2 من بايثون.
- أصبحت إضافات ZIP64 مفعّلة بصورة افتراضية في الإصدار 3.4 من بايثون.
خصائص الصنف ZipInfo
ZipInfo.filename
اسم الملف في الأرشيف.
ZipInfo.date_time
تاريخ وزمن آخر تعديل أجري على العضو في الأرشيف. هذه الخاصية عبارة عن صفّ يحتوي على ستّ قيم:
التسلسل | القيمة |
---|---|
0 | السنة (>= 1980) |
1 | الشهر (يبدأ من 1) |
2 | اليوم في الشهر (يبدأ من 1) |
3 | الساعات (تبدأ من 0) |
4 | الدقائق (تبدأ من 0) |
5 | الثواني (تبدأ من 0) |
ملاحظة: لا تدعم ملفات ZIP الأختام الزمنية التي تسبق التاريخ 1980.
ZipInfo.compress_type
نوع عملية الضغط المطبّقة على العضو في الأرشيف.
ZipInfo.comment
التعليق المرتبط بالعضو في الأرشيف.
ZipInfo.extra
بيانات Expansion field. تحتوي الملاحظات الخاصة بتطبيق PKZIP على بعض التوضيحات بخصوص البنية الداخلية للبيانات التي تتضمّنها هذه السلسلة النصية.
ZipInfo.create_system
النظام الذي أنشأ ملف ZIP.
ZipInfo.create_version
إصدار تطبيق PKZIP الذي أنشأ ملف ZIP.
ZipInfo.extract_version
إصدار تطبيق PKZIP الواجب استخدامه لاستخراج الملفات من ملف ZIP.
ZipInfo.reserved
يجب أن تكون صفرًا.
ZipInfo.flag_bits
رايات البتات flag bits الخاصّة بملف ZIP.
ZipInfo.volume
رقم الإصدار volume لترويسة الملف.
ZipInfo.internal_attr
الخصائص الداخلية.
ZipInfo.external_attr
الخصائص الخارجية للملف.
ZipInfo.header_offset
مقدار الإزاحة بالبايتات إلى ترويسة الملف.
ZipInfo.CRC
CRC-32 للملفات غير المضغوطة.
ZipInfo.compress_size
حجم البيانات المضغوطة.
ZipInfo.file_size
حجم الملفات غير المضغوطة.
توابع الصنف ZipInfo
تابع الصنف ZipInfo.from_file()
ينشئ تابع الصنف هذا كائن ZipInfo
للملف المعطى، ويهيّئه لإضافته إلى ملف zip.
التابع ZipInfo.is_dir()
يتحقّق التابع ممّا إذا كان عضو الأرشيف مجلّدًا folder أم لا.
أمثلة
يبين المثال التالي طريقة إنشاء كائن PyZipFile
يدعم الكتابة:
>>> import zipfile
>>> pyzip = zipfile.PyZipFile('files.zip', 'w')
انظر أيضًا
- الصنف
ZipFile
: يستخدم هذا الصنف لقراءة ملفات ZIP والكتابة فيها. - الصنف
PyZipFile
: يستخدم هذا الصنف لإنشاء ملفات ZIP تتضمّن مكتبات بايثون.