Python/pathlib/Path/rename

التابع PurePath.rename في بايثون

يعيد تسمية الملف أو المجلد بما يحدده الوسيط المُعطى. في نظام يونكس، إذا كان اسم الملف بعد إعادة التسمية موجودًا فعلًا كملف، فإنه يُستبدل دون أي إنذار إذا لدى المستخدم الصلاحيات اللازمة لذلك.

يمكن أن يكون الوسيط الي يحدد اسم الملف بعد إعادة التسمية سلسلة نصية أو كائن مسار آخر.

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

>>> p = Path('foo')

>>> p.open('w').write('some text')
9

>>> target = Path('bar')

>>> p.rename(target)

>>> target.open().read()
'some text'

المعاملات

يمكن أن يكون الوسيط الذي يحدد اسم الملف بعد إعادة التسمية سلسلة نصية أو كائن مسار آخر.

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

يعيد تسمية الملف أو المجلد بما يحدده الوسيط المُعطى. في نظام يونكس، إذا كان اسم الملف بعد إعادة التسمية موجودًا فعلًا كملف، فإنه يُستبدل دون أي إنذار إذا لدى المستخدم الصلاحيات اللازمة لذلك.

أمثلة

يبين المثال التالي طريقة استخدام التابع:

>>> p = Path('foo')

>>> p.open('w').write('some text')
9

>>> target = Path('bar')

>>> p.rename(target)

>>> target.open().read()
'some text'