الفرق بين المراجعتين لصفحة: «Python/TarInfo»
لا ملخص تعديل |
|||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE:الصنف <code>TarInfo()</code> في بايثون}}</noinclude> | ||
يمثّل كائن <code>TarInfo</code> عضوًا واحدًا في كائن <code>[[Python/TarFile|TarFile]]</code>. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف. | يمثّل كائن <code>TarInfo</code> عضوًا واحدًا في كائن <code>[[Python/TarFile|TarFile]]</code>. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف. | ||
| سطر 6: | سطر 6: | ||
== البنية العامة == | == البنية العامة == | ||
الدالة البانية | الدالة البانية للصنف <code>TarInfo</code>:<syntaxhighlight lang="python3"> | ||
class tarfile.TarInfo(name="") | class tarfile.TarInfo(name="") | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == خصائص كائنات <code>TarInfo</code> == | ||
يمتلك كائن <code>TarInfo</code> الخصائص العامة التالية: | |||
=== | === <code>TarInfo.name</code> === | ||
اسم عضو الأرشيف. | |||
=== <code>TarInfo.size</code> === | |||
الحجم بالبايتات. | |||
=== <code>TarInfo.mtime</code> === | |||
وقت آخر تعديل. | |||
=== <code>TarInfo.mode</code> === | |||
أذونات الملف. | |||
=== <code>TarInfo.type</code> === | |||
نوع الملف، والذي يكون عادة واحدًا من الثوابت التالية: <code>REGTYPE</code>، <code>AREGTYPE</code>، <code>LNKTYPE</code>، <code>SYMTYPE</code>، <code>DIRTYPE</code>، <code>FIFOTYPE</code>، <code>CONTTYPE</code>، <code>CHRTYPE</code>، <code>BLKTYPE</code>، <code>GNUTYPE_SPARSE</code>. لتحديد نوع كائن <code>TarInfo</code> بطريقة أفضل استخدم توابع <code>is*()</code>. | |||
=== التابع <code>TarInfo.tobuf()</code> === | === <code>TarInfo.linkname</code> === | ||
اسم الملف المستهدف، والذي يكون موجودًا فقط في كائنات <code>TarInfo</code> من نوع <code>LNKTYPE</code> و <code>SYMTYPE</code>. | |||
=== <code>TarInfo.uid</code> === | |||
المعرّف الخاص بالمستخدم الذي خزّن هذا العضو في ملف الأرشيف. | |||
=== <code>TarInfo.gid</code> === | |||
معرّف المجموعة الخاص بالمستخدم الذي خزّن هذا العضو في ملف الأرشيف. | |||
=== <code>TarInfo.uname</code> === | |||
اسم المستخدم. | |||
=== <code>TarInfo.gname</code> === | |||
اسم المجموعة. | |||
=== <code>TarInfo.pax_headers</code> === | |||
[[Python/dict|قاموس]] يحتوي على أزواج مفتاح-قيمة لترويسات pax الموسّعة والمرتبطة بالملف. | |||
== توابع كائنات TarInfo == | |||
=== تابع الصنف [[Python/TarInfo/frombuf|<code>TarInfo.frombuf()</code>]] === | |||
تابع صنف <code>classmethod</code> ينشئ ويعيد كائن <code>TarInfo</code> من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة. | |||
=== تابع الصنف <code>[[Python/TarInfo/fromtarfile|TarInfo.fromtarfile()]]</code> === | |||
تابع صنف يقرأ العضو التالي من كائن <code>[[Python/TarFile|TarFile]]</code> المعطى ويعيده على هيئة كائن <code>TarInfo</code>. | |||
=== التابع <code>[[Python/TarInfo/tobuf|TarInfo.tobuf()]]</code> === | |||
ينشئ التابع سلسلة ذاكرة نصية من كائن <code>TarInfo</code>. | |||
== توابع الاستعلام == | == توابع الاستعلام == | ||
المراجعة الحالية بتاريخ 20:42، 14 نوفمبر 2018
يمثّل كائن TarInfo عضوًا واحدًا في كائن TarFile. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف.
تعيد التوابع getmember() و getmembers() و gettarinfo() كائنات TarInfo.
البنية العامة
الدالة البانية للصنف TarInfo:
class tarfile.TarInfo(name="")
خصائص كائنات TarInfo
يمتلك كائن TarInfo الخصائص العامة التالية:
TarInfo.name
اسم عضو الأرشيف.
TarInfo.size
الحجم بالبايتات.
TarInfo.mtime
وقت آخر تعديل.
TarInfo.mode
أذونات الملف.
TarInfo.type
نوع الملف، والذي يكون عادة واحدًا من الثوابت التالية: REGTYPE، AREGTYPE، LNKTYPE، SYMTYPE، DIRTYPE، FIFOTYPE، CONTTYPE، CHRTYPE، BLKTYPE، GNUTYPE_SPARSE. لتحديد نوع كائن TarInfo بطريقة أفضل استخدم توابع is*().
TarInfo.linkname
اسم الملف المستهدف، والذي يكون موجودًا فقط في كائنات TarInfo من نوع LNKTYPE و SYMTYPE.
TarInfo.uid
المعرّف الخاص بالمستخدم الذي خزّن هذا العضو في ملف الأرشيف.
TarInfo.gid
معرّف المجموعة الخاص بالمستخدم الذي خزّن هذا العضو في ملف الأرشيف.
TarInfo.uname
اسم المستخدم.
TarInfo.gname
اسم المجموعة.
TarInfo.pax_headers
قاموس يحتوي على أزواج مفتاح-قيمة لترويسات pax الموسّعة والمرتبطة بالملف.
توابع كائنات TarInfo
تابع الصنف TarInfo.frombuf()
تابع صنف classmethod ينشئ ويعيد كائن TarInfo من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة.
تابع الصنف TarInfo.fromtarfile()
تابع صنف يقرأ العضو التالي من كائن TarFile المعطى ويعيده على هيئة كائن TarInfo.
التابع TarInfo.tobuf()
ينشئ التابع سلسلة ذاكرة نصية من كائن TarInfo.
توابع الاستعلام
يقدّم كائن TarInfo كذلك التوابع التالية التي تسهّل إجراء الاستعلامات:
التابع TarInfo.isfile()
يعيد التابع القيمة True إن كان كائن TarInfo ملفًّا عاديًا.
التابع TarInfo.isreg()
هذا التابع مشابه في عمله للتابع isfile().
التابع TarInfo.isdir()
يعيد التابع القيمة True إن كان كائن TarInfo مجلّدًا.
التابع TarInfo.issym()
يعيد التابع القيمة True إن كان كائن TarInfo وصلة رمزية symbolic link.
التابع TarInfo.islnk()
يعيد التابع القيمة True إن كان كائن TarInfo وصلة صلبة hard link.
التابع TarInfo.ischr()
يعيد التابع القيمة True إن كان كائن TarInfo أداة محارف character device.
التابع TarInfo.isblk()
يعيد التابع القيمة True إن كان كائن TarInfo أداة كتلة block device.
التابع TarInfo.isfifo()
يعيد التابع القيمة True إن كان كائن TarInfo من نوع FIFO.
التابع TarInfo.isdev()
يعيد التابع القيمة True إن كان كائن TarInfo أداة محارف أو أداة كتلة أو من نوع FIFO.
انظر أيضًا
الكائن TarFile: وظيفة هذا الصنف هي قراءة ملفات الأرشيف من نوع tar والكتابة فيها.
مصادر
صفحة Read and write tar archive files في توثيق بايثون الرسمي.