Python/pathlib/Path/group

التابع Path.group في بايثون

يعيد هذا التابع اسم المجموعة التي ينتمي لها الملف، ويرمي الخطأ KeyError إذا كان معرف المجموعة gid الخاص بالملف غير موجود في قاعدة بيانات النظام.

ملاحظة: هذا التابع لا يعمل على نظام ويندوز، ويرمي بالخطأ NotImplementedError في حال استخدامه في نظام ويندوز ، حيث نجد تعريف التابع في الشيفرة المصدرية كما يلي:

   def group(self):
        raise NotImplementedError("Path.group() is unsupported on this system")

وهو يعتمد على نتيجة استدعاء التابع stat لتحديد معرف المجموعة، ثم يستخدم التابع getgrgid من الوحدة grp للحصول على المعلومات الخاصة بالمجموعة.

>>>import pathlib
>>>pathlib.Path('.').stat().st_gid
1000

>>>import grp#موجودة فقط في يونكس
    
>>>grp.getgrgid(pathlib.Path('.').stat().st_gid)
grp.struct_group(gr_name='runner', gr_passwd='x', gr_gid=1000, gr_mem=[])

>>>grp.getgrgid(pathlib.Path('.').stat().st_gid).gr_name
'runner'

البنية العامة

يُستخدم التابع ببساطة عن طريق استدعائه في نظام يونكس.

المعاملات

بدون معاملات

القيمة المعادة

يعيد هذا التابع اسم المجموعة التي ينتمي لها الملف، ويرمي بالخطأ KeyError إذا كان معرف المجموعة gid الخاص بالملف غير موجود في قاعدة بيانات النظام.

أمثلة

>>>from pathlib import Path

>>>p=Path()

>>>p
PosixPath('.')

>>>print(p.group())
runner

انظر أيضًا

التابع stat للحصول على معلومات الملف.

مصادر

قسم الوحدة pathlib في توثيق بايثون الرسمي.