الفرق بين المراجعتين لصفحة: «Python/TarInfo»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الكائن <code>TarInfo()</code> في بايثون}}</noinclude> يمثّل كائن TarInfo عضوًا واحدًا في كائن Ta...' |
|||
| (3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE:الصنف <code>TarInfo()</code> في بايثون}}</noinclude> | ||
يمثّل كائن TarInfo عضوًا واحدًا في كائن TarFile. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف. | يمثّل كائن <code>TarInfo</code> عضوًا واحدًا في كائن <code>[[Python/TarFile|TarFile]]</code>. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف. | ||
تعيد التوابع getmember() و getmembers() و gettarinfo() كائنات TarInfo. | تعيد التوابع <code>[[Python/TarFile/getmember|getmember()]]</code> و <code>[[Python/TarFile/getmembers|getmembers()]]</code> و <code>[[Python/TarFile/gettarinfo|gettarinfo()]]</code> كائنات <code>TarInfo</code>. | ||
== البنية العامة == | == البنية العامة == | ||
الدالة البانية للصنف <code>TarInfo</code>:<syntaxhighlight lang="python3"> | |||
<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.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 == | |||
== تابع الصنف 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>. | |||
== التابع TarInfo.tobuf() == | === التابع <code>[[Python/TarInfo/tobuf|TarInfo.tobuf()]]</code> === | ||
ينشئ التابع سلسلة ذاكرة نصية من كائن <code>TarInfo</code>. | |||
== توابع الاستعلام == | == توابع الاستعلام == | ||
يقدّم كائن <code>TarInfo</code> كذلك التوابع التالية التي تسهّل إجراء الاستعلامات: | |||
=== التابع <code>TarInfo.isfile()</code>=== | === التابع <code>TarInfo.isfile()</code>=== | ||
يعيد التابع القيمة True إن كان كائن TarInfo ملفًّا عاديًا. | يعيد التابع القيمة <code>True</code> إن كان كائن <code>TarInfo</code> ملفًّا عاديًا. | ||
=== التابع <code> TarInfo.isreg() </code>=== | === التابع <code> TarInfo.isreg() </code>=== | ||
هذا التابع مشابه في عمله للتابع isfile(). | هذا التابع مشابه في عمله للتابع <code>isfile()</code>. | ||
=== التابع <code> TarInfo.isdir() </code>=== | === التابع <code> TarInfo.isdir() </code>=== | ||
يعيد التابع القيمة True إن كان كائن TarInfo مجلّدًا. | يعيد التابع القيمة True إن كان كائن <code>TarInfo</code> مجلّدًا. | ||
=== التابع <code> TarInfo.issym() </code>=== | === التابع <code> TarInfo.issym() </code>=== | ||
يعيد التابع القيمة True إن كان كائن TarInfo وصلة رمزية symbolic link. | يعيد التابع القيمة <code>True</code> إن كان كائن <code>TarInfo</code> وصلة رمزية symbolic link. | ||
=== التابع <code> TarInfo.islnk() </code>=== | === التابع <code> TarInfo.islnk() </code>=== | ||
يعيد التابع القيمة True إن كان كائن TarInfo وصلة صلبة hard link. | يعيد التابع القيمة <code>True</code> إن كان كائن <code>TarInfo</code> وصلة صلبة hard link. | ||
=== التابع <code> TarInfo.ischr() </code>=== | === التابع <code> TarInfo.ischr() </code>=== | ||
يعيد التابع القيمة True إن كان كائن TarInfo أداة محارف character device. | يعيد التابع القيمة <code>True</code> إن كان كائن <code>TarInfo</code> أداة محارف character device. | ||
=== التابع <code> TarInfo.isblk() </code>=== | === التابع <code> TarInfo.isblk() </code>=== | ||
يعيد التابع القيمة True إن كان كائن TarInfo أداة كتلة block device. | يعيد التابع القيمة <code>True</code> إن كان كائن <code>TarInfo</code> أداة كتلة block device. | ||
=== التابع <code> TarInfo.isfifo() </code>=== | === التابع <code> TarInfo.isfifo() </code>=== | ||
يعيد التابع القيمة True إن كان كائن TarInfo من نوع FIFO. | يعيد التابع القيمة <code>True</code> إن كان كائن <code>TarInfo</code> من نوع FIFO. | ||
=== التابع <code> TarInfo.isdev() </code>=== | === التابع <code> TarInfo.isdev() </code>=== | ||
يعيد التابع القيمة True إن كان كائن TarInfo أداة محارف أو أداة كتلة أو من نوع FIFO. | يعيد التابع القيمة <code>True</code> إن كان كائن <code>TarInfo</code> أداة محارف أو أداة كتلة أو من نوع FIFO. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
[[Python/TarFile|الكائن <code>TarFile</code>]]: وظيفة هذا الصنف هي قراءة ملفات الأرشيف من نوع tar والكتابة فيها. | |||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 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 في توثيق بايثون الرسمي.