الفرق بين المراجعتين لصفحة: «Python/TarInfo»
لا ملخص تعديل |
|||
| سطر 14: | سطر 14: | ||
يمتلك كائن <code>TarInfo</code> الخصائص العامة التالية: | يمتلك كائن <code>TarInfo</code> الخصائص العامة التالية: | ||
=== TarInfo.name === | === <code>TarInfo.name</code> === | ||
اسم عضو الأرشيف. | اسم عضو الأرشيف. | ||
=== TarInfo.size === | === <code>TarInfo.size</code> === | ||
الحجم بالبايتات. | الحجم بالبايتات. | ||
=== TarInfo.mtime === | === <code>TarInfo.mtime</code> === | ||
وقت آخر تعديل. | وقت آخر تعديل. | ||
=== TarInfo.mode === | === <code>TarInfo.mode</code> === | ||
أذونات الملف. | أذونات الملف. | ||
=== TarInfo.type === | === <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>. | ||
=== TarInfo.linkname === | === <code>TarInfo.linkname</code> === | ||
اسم الملف المستهدف، والذي يكون موجودًا فقط في كائنات TarInfo من نوع LNKTYPE و SYMTYPE. | اسم الملف المستهدف، والذي يكون موجودًا فقط في كائنات <code>TarInfo</code> من نوع <code>LNKTYPE</code> و <code>SYMTYPE</code>. | ||
=== TarInfo.uid === | === <code>TarInfo.uid</code> === | ||
المعرّف الخاص بالمستخدم الذي خزّن هذا العضو في ملف الأرشيف. | المعرّف الخاص بالمستخدم الذي خزّن هذا العضو في ملف الأرشيف. | ||
=== TarInfo.gid === | === <code>TarInfo.gid</code> === | ||
معرّف المجموعة الخاص بالمستخدم الذي خزّن هذا العضو في ملف الأرشيف. | معرّف المجموعة الخاص بالمستخدم الذي خزّن هذا العضو في ملف الأرشيف. | ||
=== TarInfo.uname === | === <code>TarInfo.uname</code> === | ||
اسم المستخدم. | اسم المستخدم. | ||
=== TarInfo.gname === | === <code>TarInfo.gname</code> === | ||
اسم المجموعة. | اسم المجموعة. | ||
=== TarInfo.pax_headers === | === <code>TarInfo.pax_headers</code> === | ||
قاموس يحتوي على أزواج مفتاح-قيمة لترويسات pax الموسّعة والمرتبطة بالملف. | [[Python/dict|قاموس]] يحتوي على أزواج مفتاح-قيمة لترويسات pax الموسّعة والمرتبطة بالملف. | ||
== توابع كائنات TarInfo == | == توابع كائنات TarInfo == | ||
=== تابع الصنف <code>TarInfo.frombuf()</code> === | === تابع الصنف <code>TarInfo.frombuf()</code> === | ||
تابع صنف classmethod ينشئ ويعيد كائن TarInfo من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة. | تابع صنف <code>classmethod</code> ينشئ ويعيد كائن <code>TarInfo</code> من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة. | ||
=== تابع الصنف <code>TarInfo.fromtarfile()</code> === | === تابع الصنف <code>TarInfo.fromtarfile()</code> === | ||
تابع صنف يقرأ العضو التالي من كائن TarFile المعطى ويعيده على هيئة كائن TarInfo. | تابع صنف يقرأ العضو التالي من كائن <code>[[Python/TarFile|TarFile]]</code> المعطى ويعيده على هيئة كائن <code>TarInfo</code>. | ||
=== التابع <code>TarInfo.tobuf()</code> === | === التابع <code>TarInfo.tobuf()</code> === | ||
ينشئ التابع سلسلة ذاكرة نصية من كائن TarInfo. | ينشئ التابع سلسلة ذاكرة نصية من كائن <code>TarInfo</code>. | ||
== توابع الاستعلام == | == توابع الاستعلام == | ||
مراجعة 20:28، 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 في توثيق بايثون الرسمي.