الفرق بين المراجعتين لصفحة: «Python/TarFile/gettarinfo»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>TarFile.gettarinfo()</code> في بايثون}}</noinclude> ينشئ التابع كائن <code>Python/TarInfo|Tar...' |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
ينشئ التابع كائن <code>[[Python/TarInfo|TarInfo]]</code> من نتيجة استدعاء الدالة <code>[[Python/os/stat|os.stat()]]</code> أو ما يكافئها على ملف موجود فعلًا. | ينشئ التابع كائن <code>[[Python/TarInfo|TarInfo]]</code> من نتيجة استدعاء الدالة <code>[[Python/os/stat|os.stat()]]</code> أو ما يكافئها على ملف موجود فعلًا. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 9: | سطر 7: | ||
TarFile.gettarinfo(name=None, arcname=None, fileobj=None) | TarFile.gettarinfo(name=None, arcname=None, fileobj=None) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
=== <code> | === <code>name</code> === | ||
يمكن تسمية الملف عن طريق تمرير الاسم في المعامل name أو باستخدام كائن fileobj مع واصف للملف. ويمكن للمعامل name أن يكون كائنًا شبيهًا بالمسارات. | يمكن تسمية الملف عن طريق تمرير الاسم في المعامل <code>name</code> أو باستخدام كائن <code>fileobj</code> مع واصف للملف. ويمكن للمعامل <code>name</code> أن يكون كائنًا شبيهًا بالمسارات. | ||
=== <code>arcname</code> === | === <code>arcname</code> === | ||
معامل اختياري يعيّن اسمًا بديلًا للملف في الأرشيف، وفي حال عدم تحديد قيمة لهذا المعامل يأخذ الملف اسمه من خاصية name في كائن الملف | معامل اختياري يعيّن اسمًا بديلًا للملف في الأرشيف، وفي حال عدم تحديد قيمة لهذا المعامل يأخذ الملف اسمه من خاصية <code>name</code> في كائن الملف <code>fileobj</code>، أو من المعامل <code>name</code>. يجدر التنبيه إلى وجوب أن يكون الاسم [[Python/str|سلسلة نصية]]. | ||
يمكن تعديل بعض الخصائص في كائنات TarInfo قبل إضافته باستخدامه التابع addfile. إن لم يكن كائن الملف عاديًّا وموجودًا في بداية الملف، فإنّ بعض الخصائص مثل size قد تحتاج إلى تعديل، وهذه هي الحال مع كائنات مثل GzipFile. كذلك يمكن تعديل الاسم وفي هذه الحال يجب أن يكون المعامل arcname سلسلة نصية وهمية. | يمكن تعديل بعض الخصائص في كائنات <code>[[Python/TarInfo|TarInfo]]</code> قبل إضافته باستخدامه التابع <code>addfile</code>. إن لم يكن كائن الملف عاديًّا وموجودًا في بداية الملف، فإنّ بعض الخصائص مثل <code>size</code> قد تحتاج إلى تعديل، وهذه هي الحال مع كائنات مثل <code>[[Python/GzipFile|GzipFile]]</code>. كذلك يمكن تعديل الاسم وفي هذه الحال يجب أن يكون المعامل <code>arcname</code> سلسلة نصية وهمية. | ||
'''ملاحظة:''' أصبح بالإمكان استخدام كائنات شبيهة بالمسارات path-like objects مع المعامل name في الإصدار 3.6 من بايثون. | '''ملاحظة:''' أصبح بالإمكان استخدام كائنات شبيهة بالمسارات path-like objects مع المعامل <code>name</code> في الإصدار 3.6 من بايثون. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
يعيد التابع كائن TarInfo. | يعيد التابع كائن <code>[[Python/TarInfo|TarInfo]]</code>. | ||
== أمثلة == | == أمثلة == | ||
| سطر 32: | سطر 29: | ||
>>> tar_info = tar.gettarinfo('file5.js') | >>> tar_info = tar.gettarinfo('file5.js') | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 20:02، 14 نوفمبر 2018
ينشئ التابع كائن TarInfo من نتيجة استدعاء الدالة os.stat() أو ما يكافئها على ملف موجود فعلًا.
البنية العامة
TarFile.gettarinfo(name=None, arcname=None, fileobj=None)
المعاملات
name
يمكن تسمية الملف عن طريق تمرير الاسم في المعامل name أو باستخدام كائن fileobj مع واصف للملف. ويمكن للمعامل name أن يكون كائنًا شبيهًا بالمسارات.
arcname
معامل اختياري يعيّن اسمًا بديلًا للملف في الأرشيف، وفي حال عدم تحديد قيمة لهذا المعامل يأخذ الملف اسمه من خاصية name في كائن الملف fileobj، أو من المعامل name. يجدر التنبيه إلى وجوب أن يكون الاسم سلسلة نصية.
يمكن تعديل بعض الخصائص في كائنات TarInfo قبل إضافته باستخدامه التابع addfile. إن لم يكن كائن الملف عاديًّا وموجودًا في بداية الملف، فإنّ بعض الخصائص مثل size قد تحتاج إلى تعديل، وهذه هي الحال مع كائنات مثل GzipFile. كذلك يمكن تعديل الاسم وفي هذه الحال يجب أن يكون المعامل arcname سلسلة نصية وهمية.
ملاحظة: أصبح بالإمكان استخدام كائنات شبيهة بالمسارات path-like objects مع المعامل name في الإصدار 3.6 من بايثون.
القيمة المعادة
يعيد التابع كائن TarInfo.
أمثلة
يبين المثال التالي آلية عمل التابع:
>>> import tarfile
>>> tar = tarfile.open('files.tar', 'w')
>>> tar_info = tar.gettarinfo('file5.js')
مصادر
صفحة Read and write tar archive files في توثيق بايثون الرسمي.