الملفات في بايثون |Python files

صدام العويري

اخر تحديث :

التعامل مع الملفات في بايثون

التعامل مع الملفات أو معالجة الملفات ( Files Handling ) يقصد منها إجراء عملية ما على الملفات على مختلف انواعها ( مثل txt - jpg - mp4 ).
في هذا الدرس ستتعلم كيف تقرأ محتوى ملف, كيف تنشئ نسخة منه, كيف تعدل محتواه, كيف تحذفه إلخ..

الدالة `open()` في بايثون

هذه الدالة هي من الدوال الجاهزة في بايثون و هي تستخدم لإنشاء ملف جديد أو لفتح الملف الذي سيتم التعامل معه.
في حال تم إنشاء الملف بشكل صحيح أو تم فتح الملف بشكل صحيح ترجع كائن file يتيح لك التعامل معه.
في حال لم تستطع إنشاء الملف أو الوصول إليه ترمي إستثناء.

بناؤها

open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None)

مكان البارميتر file نمرر نص يمثل إسم الملف الذي سيتم إنشاؤه أو التعامل معه.
mode هو باراميتر إختياري, نمرر مكانه حرف ( أو أكثر ) يمثل كيف سنتعامل مع الملف, مثل: هل تنوي القراءة منه أو الكتابة فيها إلخ..
buffering هو باراميتر إختياري, يمكنك أن تمرر مكانه رقم يحدد كيف سيتم تخزين الأحرف بشكل مؤقت في الذاكرة أثناء الكتابة أو القراءة من الملف.
encoding هو باراميتر إختياري, يمكنك أن تمرر مكانه إسم الترميز الذي يجب استخدامه عند التعامل مع الملف.
errors هو باراميتر إختياري, يمكنك أن تمرر مكانه كلمة لتحدد كيف سيتم التعامل مع الأخطاء التي قد تحدث عند التعامل مع الملف.
newline هو باراميتر إختياري, يمكنك أن تمرر مكانه الرمز الذي يمثل نهاية كل سطر في الملف و الذي يجعل النص الذي يوضع بعضه ينزل على سطر جديد.

أهم باراميتر إختياري في هذه الدالة هو الباراميتر mode لأنه كما سبق و قلنا أن الحرف الذي نمرره مكانه يحدد الهدف من فتح الملف.
في الجدول التالي وضعنا كل الحروف التي يمكن تمريرها مكان هذا الباراميتر.

الحرف	معناه	مثال
`'r'`	يعتبر إختصار للكلمة Read, و هو يستخدم لفتح الملف من أجل القراءة منه. كما أنه الـ Mode الإفتراضي للملف الذي تفتحه.	شاهد المثال »
`'w'`	يعتبر إختصار للكلمة Write, و هو يستخدم لفتح الملف من أجل الكتابة فيه. و في حال لم يكن الملف المراد الكتابة فيه موجوداً أصلاً, سيتم إنشاؤه. ملاحظة: هذا الحرف يقوم بحذف النص الذي كان موجوداً في الملف في حال لم يكن فارغاَ.	شاهد المثال »
`'a'`	يعتبر إختصار للكلمة Append, و هو يستخدم لفتح الملف من أجل الكتابة في آخره. أي لإضافة نص جديد على النص الموجود في الملف. و في حال لم يكن الملف المراد الكتابة فيه موجوداً أصلاً, سيتم إنشاؤه.	شاهد المثال »
`'x'`	يعتبر إختصار للكلمة Create, و هو يستخدم لإنشاء ملف جديد فقط في حال لم يكن موجوداً.	شاهد المثال »
`'t'`	يعتبر إختصار للكلمة Text, و هو يستخدم لتحديد أن محتوى الملف عبارة عن نص عادي. كما أنه الـ Mode الإفتراضي للملف الذي تفتحه.	شاهد المثال »
`'b'`	يعتبر إختصار للكلمة Binary, و هو يستخدم لتحديد أن محتوى الملف عبارة عن Binary, أي أحرف لا يمكن أن يفهمها الإنسان العادي. هذا الـ Mode نستخدمه عند التعامل مع الملفات الغير نصية مثل الصور, الفيدوهات, التسجيلات الصوتية إلخ.. ملاحظة: المثال سيعلمك طريقة إنشاء نسخة من أي ملف.	شاهد المثال »
`'+'`	يعتبر إختصار للكلمتين Read & Write, و هو يستخدم لفتح الملف مع إمكانية القراءة منه و الكتابة فيه في نفس الوقت.	شاهد المثال »

ملاحظة حول الملفات في بايثون

الأحرف المذكورة في الجدول يمكن دمجها مع بعضها, أي يمكنك تحديد أكثر من Mode في وقت واحد.
فمثلاً يمكنك كتابة 'wb' من أجل فتح ملف جديد و وضع فيه نص نوعه Binary كما نفعل في حال أردنا نسخ صورة على سبيل المثال.

في المثال التالي قمنا بإنشاء ملف نصي جديد إسمه demo.txt في نفس المشروع الذي نعمل فيه.
بعدها قمنا كتابة السطر التالي بداخله Python is an easy language to learn..

مثال

Test.py

# لكي يتم إنشاء الملف و لنستطيع الكتابة فيه أيضاً 'w' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
opened_file = open('demo.txt', 'w')

# للكتابة في الملف الذي يشير إليه opened_file من الكائن write() هنا قمنا باستدعاء الدالة
opened_file.write('Python is an easy language to learn.')

# لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
opened_file.close()

•بعد تشغيل الملف Test.py سيتم إنشاء ملف إسمه demo.txt في نفس المشروع الذي نعمل فيه و بداخله النص التالي.

Python is an easy language to learn.

دوال القراءة و الكتابة في الملفات في بايثون

بعد فتح الملف الذي تريد التعامل معه بنجاح بواسطة الدالة open() يصبح بإمكانك استخدام الدوال التالية من الكائن الذي سترجعه هذه الدالة.

إسم الدالة مع تعريفها
`write(string)` تستخدم للكتابة في الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها. مكان الباراميتر `string` نمرر النص الذي نريد أن يتم كتابته في الملف. شاهد المثال »
`writelines(aList)` تستخدم لكتابة مجموعة نصوص مخزنة في `list` في الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها. مكان الباراميتر `lines` نمرر كائن `aList` فيه مجموعة النصوص التي نريد أن يتم كتابتها بنفس الترتيب في الملف. شاهد المثال »
`read(n = -1)` تستخدم للقراءة من الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها. إذا قمت باستدعائها و لم تمرر لها أي رقم, سترجع كل النص الموجود في الملف دفعة واحد. `n` هو باراميتر إختياري يمكنك أن تمرر مكانه رقم يمثل عدد الأحرف التي تريد قراءتها من الملف في حال لم ترد أن تقرأ كل محتوى الملف دفعة واحدة. مع الإشارة إلى أنك في كل مرة تقوم فيها باستدعائها ستعطيك الأحرف التالية الموجودة في الملف. شاهد المثال »
`readline(limits = -1)` تستخدم للقراءة سطراً سطراً من الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها. إذا قمت باستدعائها و لم تمرر لها أي رقم, سترجع السطر التالي الموجود في الملف. `n` هو باراميتر إختياري يمكنك أن تمرر مكانه رقم يمثل عدد الأحرف التي تريد قراءتها من السطر التالي في الملف في حال لم ترد أن تقرأ كل محتوى السطر دفعة واحدة. مع الإشارة إلى أنك في كل مرة تقوم فيها باستدعائها ستعطيك الأحرف الموجودة حتى نهاية السطر الحالي في الملف. شاهد المثال »
`readlines(limits = -1)` تستخدم لإرجاع نسخة من النص الموجود في الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها ككائن `list`. كل عنصر في كائن الـ `list` الذي ترجعه يمثل سطر موجود في الملف. إذا قمت باستدعائها و لم تمرر لها أي رقم, سيتم وضع كل الأحرف الموجودة على كل سطر في الملف في عنصر من عناصر الكائن الـ `list`. `n` هو باراميتر إختياري يمكنك أن تمرر مكانه رقم يمثل عدد الأحرف التي تريد قراءتها من كل سطر في الملف في حال لم ترد أن تقرأ كل محتوى السطر. شاهد المثال »
`tell()` ترجع رقم آخر حرف في الملف تم الوصول إليه أثناء القراءة من الملف عن طريق الكائن الذي يمثل هذا الملف. شاهد المثال »
`seek(offset, from_what=0)` أثناء القراءة من الملف عن طريق الكائن الذي يمثل هذا الملف, يمكنك إستخدام هذه الدالة في حال أردت الرجوع إلى الوراء في الملف لقراءة الملف من جديد على سبيل المثال. `from_what` هو باراميتر إختياري يمكنك أن تمرر إحدى الأرقام التالية مكانه: الرقم 0 إذا أردت الرجوع إلى أول حرف في الملف. الرقم 1 إذا أردت البقاء عند حرف الحالي الذي وصلت إليه في الملف. الرقم 2 إذا أردت الذهاب إلى آخر حرف في الملف. مكان الباراميتر `offset` تمرر رقم يمثل بعد كم حرف نسبة للبراميتر `from_what` تريد أن تبدأ. مثال: إذا قمت باستدعاء الدالة هكذا `seek(0,0)` أو هكذا `seek(0)` فهذا يعني أنك تريد العودة إلى أول حرف في الملف. شاهد المثال »
`close()` تستخدم لإغلاق الإتصال مع الملف و تنظيف الذاكرة من كل ما له علاقة بهذا الملف. ملاحظة: في حال قمت بفتح الملف بالأساس بواسطة الجملة `with` فلا داعي لإغلاق الملف لأنها تقوم بإغلاقه بشكل تلقائي عنك. شاهد المثال »

خصائص الملفات في بايثون

بالإضافة إلى الدوال السابقة, يصبح بإمكانك الإستفادة من الخصائص التالية من الكائن الذي ترجعه الدالة open().

إسم الخاصية مع تعريفها
`name` ترجع إسم الملف الذي يمثله الكائن.
`mode` ترجع الحرف أو الأحرف المستخدمة لتحديد الهدف من فتح الملف.
`encoding` ترجع إسم الترميز المستخدم في الملف الذي يمثله الكائن.
`closed` تستخدم لمعرفة ما إذا كان الكائن الذي يمثل الملف لا يزال مفتوح أم تم إغلاقه. ترجع `True` إن كان كذلك, إن لم يكن كذلك ترجع `False`.

في المثال التالي قمنا بإنشاء كائن يشير للملف demo.txt الذي أنشأناه سابقاً.
بعدها قمنا بعرض خصائص هذا الكائن و التي بدورها تعتبر خصائص الملف نفسه.

مثال

Test.py

# 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
opened_file = open('demo.txt')

# الذي يشير للملف المفتوح في الذاكرة opened_file هنا قمنا بعرض كل خصائص الكائن
print('File Name:', opened_file.name)
print('Access Mode:', opened_file.mode)
print('Encoding Type:', opened_file.encoding)
print('Is File closed:', opened_file.closed)

# لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
opened_file.close()

•سنحصل على النتيجة التالية عند تشغيل الملف Test.py.

File Name: demo.txt
Access Mode: w
Encoding Type: cp1252
Is File closed: False

الموديول `os` في بايثون

os هو موديول جاهز في بايثون يتيح لك إعادة تسمية الملفات, مسح الملفات, إنشاء مجلدات, مسح مجلدات, التنقل بين المجلدات إلخ..

لإستخدام هذا الموديول يجب تضمينه كالتالي.

import os

الجدول التالي يحتوي على دوال الموديول os الأكثر استخداماً.

إسم الدالة مع تعريفها
`os.rename(current_file_name, new_file_name)` تستخدم لتغيير إسم الملف. مكان الباراميتر `current_file_name` نمرر إسم الملف الذي نريد تغيير إسمه. مكان الباراميتر `new_file_name` نمرر الإسم الجديد الذي نريد وضعه للملف. شاهد المثال »
`os.remove(file_name)` تستخدم لمسح الملف. مكان الباراميتر `file_name` نمرر إسم الملف الذي نريد حذفه. شاهد المثال »
`os.path.exists(file_name)` تستخدم لمعرفة ما إن كان الملف موجوداً أم لا. مكان الباراميتر `file_name` نمرر إسم الملف الذي نريد التأكد ما إن كان موجوداً أم لا. ترجع `True` إذا كان الملف موجوداً. و ترجع `False` إن لم يكن كذلك. شاهد المثال »
`os.mkdir(directory_name)` تستخدم لإنشاء مجلد جديد. مكان الباراميتر `directory_name` نمرر إسم المجلد الذي نريد إنشاؤه. معلومة: إسم الدالة هو إختصار لجملة Make Directory. شاهد المثال »
`os.rmdir(directory_name)` تستخدم لمسح المجلد. مكان الباراميتر `directory_name` نمرر إسم المجلد الذي نريد حذفه. ملاحظة: يمكنك حذف المجلد في حال كان فارغاً فقط, أي في حال لم يكن يحتوي على أي ملف بداخله. معلومة: إسم الدالة هو إختصار لجملة Remove Directory. شاهد المثال »
`os.getcwd()` تستخدم لمعرفة إسم المجلد الذي تقف بداخله حالياً. معلومة: إسم الدالة هو إختصار لجملة Get Current Working Directory. شاهد المثال »

البلوك `with` في بايثون

يمكنك الإستفادة من إستخدام أسلوب البلوك with في حال أردت أن يتم إغلاق الملفات التي تفتحها في برامجك بشكل تلقائي و بدون الحاجة لإستدعاء الدالة close().

طريقة تعريف البلوك with:

with expression [as variable]:
    #with-block

expression: نضع مكانه الأمر الذي سيرجع لنا كائن يشير الملف الذي تم فتحه في الذاكرة.
variable: نضع مكانه إسم الكائن الذي نريد من خلاله أن نتعامل مع الملف الذي تم فتحه في الذاكرة.
#with-block: مكان هذا التعليق نضع الأوامر التي نريد تنفيذها بعد أن تم فتح الملف بنجاح.

في المثال التالي قمنا بفتح ملف و قراءة النص الموجود فيه بدون الحاجة لإغلاقه عند الإنتهاء منه لأننا وضعنا الكود بداخل بلوك الكلمة with.

مثال

Test.py

# بعدها قمنا بطباعة النص الموجود فيه 'demo.txt' يشير للملف opened_file هنا قمنا بإنشاء كائن إسمه
with open('demo.txt', 'r') as opened_file:
	print(opened_file.read())

# هنا قمنا بطباعة ما إن كان الملف لا يزال مفتوحاً في الذاكرة أم أنه تم إغلاقه
print('Is File Closed:', opened_file.closed)

•بعد تشغيل الملف Test.py سيتم طباعة كل النص الموجود في الملف demo.txt الذي إفترضنا أننا أنشأناه سابقاً في نفس المشروع الذي نعمل فيه.
•نلاحظ أن الدالة closed() أرجعت القيمة True و هذا يعني أنه تم إغلاق الملف من الذاكرة بشكل تلقائي عند إنتهاء البلوك with.

Python is an easy language to learn.
Is File Closed: True

تخزين أحرف عربية في الملف في بايثون

إذا حاولت كتابة أحرف عربية في ملف و لم تحدد أن نوع الترميز المستخدم عند التعامل مع الملف هو utf-8 سيظهر أمامك الخطأ 'charmap' codec can't encode.
و إذا حاولت قراءة نص عربي موجود في ملف و لم تحدد نوع الترميز ستلاحظ أن النص يظهر بشكل غير مفهوم كالتالي Ø§Ù„Ø³Ù„Ø§Ù… Ø¹Ù„ÙŠÙƒÙ….

في المثال التالي قمنا بإنشاء ملف إسمه arabic.txt قمنا بتخزين نص عربي فيه و بعدها قمنا بقراءة النص الموجود فيه.

مثال

Test.py

# 'Test.py' سيتم إنشاؤه في نفس المشروع بجانب الملف 'arabic.txt' يشير لملف جديد إسمه opened_file هنا قمنا بإنشاء كائن إسمه
# لنستطيع التعامل مع الأحرف العربية 'utf-8' حتى يتم إنشاء الملف و يكون لدينا القدرة على الكتابة و القراءة منه في نفس الوقت. كما أننا حددنا نوع الترميز هو 'w+' وضعنا الرمز
opened_file = open('arabic.txt', 'w+', encoding='utf-8')

# لكتابة نص جديد في الملف الذي يشير إليه و لاحظ أننا أدخلنا نص عربي  opened_file من الكائن write() هنا قمنا باستدعاء الدالة
opened_file.write('السلام عليكم و رحمة الله و بركاته')

# للعودة لأول الملف seek() هنا قمنا باستدعاء الدالة
opened_file.seek(0,0)

# الذي يشير للملف المفتوح حتى ترجع كل النص الموجود فيه, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
print(opened_file.read())

# لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
opened_file.close()

•بعد تشغيل الملف Test.py سيتم إنشاء الملف arabic.txt و تخزين النص العربي بداخله. أيضاً سيتم طباعة النص العربي الموجود في الأساس بداخل الملف كالتالي.

السلام عليكم و رحمة الله و بركاته

التعامل مع الملفات بطريقة آمنة في بايثون

عند التعامل مع الملفات قد تواجهك عدة مشاكل قد يكون سببها نظام التشغيل أو المستخدم.
لذلك عليك دائماً حماية الكود الذي من خلاله ستتعامل مع الملفات بالجمل try.. except التي شرحناها سابقاً.

بعض المشاكل التي قد تحدث معك أثناء التعامل مع الملفات:

إذا كان مسار الملف الذي تريد التعامل معه مذكور بشكل غير صحيح.
إذا كنت تحاول قراءة محتوى ملف غير موجود أصلاً أو تم مسحه.
إذا كنت تريد الكتابة بالعربية و لم تحدد أن نوع الترميز الذي يجب أن يستخدم هو 'utf-8'.
إذا كنت تحاول التعامل مع صورة أو فيديو و لم تحدد أن نوع هذا الملف هو Binary كما شرحنا قبل قليل.
إذا كان الملف عليه صلاحية القراءة فقط ( Read Only ) لا يمكنك تعديل النص الموجود فيه بأي شكل أو مسح الملف نفسه من الحاسوب.
في حال كنت تريد إنشاء مجلد أو ملف و لم تكن تملك الصلاحيات التي تخولك لذلك. فمثلاً في نظام ويندوز لا تستطيع إنشاء ملف على المسار C:\ إذا لم تكن تملك صلاحيات مدير النظام.

في المثال التالي سنقوم بفتح الملف و التعامل معه بداخل بلوك try.. except لضمان أن لا تحدث أي مشكلة تؤدي إلى تعليق البرنامج و لعرض أي خطأ قد يحدث أيضاً.

المثال الأول

Test.py

# من أجل عرض النص الموجود فيه 'harmash.txt' هنا حاولنا إيجاد و فتح ملف إسمه
try:
    opened_file = open('harmash.txt', 'r')
    print(opened_file.read())
    opened_file.close()

# و من ثم عرضها كنص عادي ex بما أنه لا يوجد هكذا ملف في المشروع, سيتم تخزين معلومات الخطأ الذي حدث في الكائن
except Exception as ex:
    print(ex)
	
print('Program still work properly')

•بعد تشغيل الملف Test.py سيتم طباعة المشكلة التي حدثت أثناء محاولة القراءة من الملف كنص عادي و لن يؤدي ذلك إلى تعليق البرنامج.

[Errno 2] No such file or directory: 'harmash.txt'
Program still work properly

هنا قمنا بإعادة المثال السابق تماماً لكننا حاولنا فتح الملف بوسطة البلوك with.
لاحظ أن النتيجة هي نفسها في الحالتين.

المثال الثاني

Test.py

# من أجل عرض النص الموجود فيه 'harmash.txt' هنا حاولنا إيجاد و فتح ملف إسمه
try:
    with open('harmash.txt', 'r') as opened_file:
		print(opened_file.read())

# و من ثم عرضها كنص عادي ex بما أنه لا يوجد هكذا ملف في المشروع, سيتم تخزين معلومات الخطأ الذي حدث في الكائن
except Exception as ex:
    print(ex)
	
print('Program still work properly')

•بعد تشغيل الملف Test.py سيتم طباعة المشكلة التي حدثت أثناء محاولة القراءة من الملف كنص عادي و لن يؤدي ذلك إلى تعليق البرنامج.

[Errno 2] No such file or directory: 'harmash.txt'
Program still work properly

قراءة النص الموجود في ملف في بايثون

تذكر: الرمز r الذي نضعه في الدالة open() يعتبر إختصار للكلمة Read, و هو يستخدم لفتح الملف من أجل القراءة منه.
كما أنه الـ Mode الإفتراضي للملف الذي تفتحه.

مثال

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن للقراءة من الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح حتى ترجع النص الموجود فيه, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
                    print(opened_file.read())

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم قراءة محتوى الملف demo.txt و من ثم عرضه كالتالي.

Python is an easy language to learn. <-- هنا افترضنا أن هذا النص كان موجوداً أصلاً في الملف

تخزين النص في ملف في بايثون

تذكر: الرمز w الذي نضعه في الدالة open() يعتبر إختصار للكلمة Write, و هو يستخدم لفتح الملف من أجل الكتابة فيه.
و في حال لم يكن الملف المراد الكتابة فيه موجوداً أصلاً, سيتم إنشاؤه.
و لا تنسى أن هذا الحرف يقوم بحذف النص الذي كان موجوداً في الملف في حال لم يكن فارغاَ.

مثال

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لكتابة نص جديد في الملف 'w' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'w')

                    # لكتابة نص جديد في الملف الذي يشير إليه opened_file من الكائن write() هنا قمنا باستدعاء الدالة
                    opened_file.write('This new text will replace the old text.')

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم إنشاء ملف إسمه demo.txt في نفس المشروع الذي نعمل فيه و بداخله النص التالي.

This new text will replace the old text.

إضافة نص جديد على النص الموجود في ملف في بايثون

تذكر: الرمز a الذي نضعه في الدالة open() يعتبر إختصار للكلمة Append, و هو يستخدم لفتح الملف من أجل الكتابة في آخره.
أي يستخدم لإضافة نص جديد على النص الموجود في الملف.
و في حال لم يكن الملف المراد الكتابة فيه موجوداً أصلاً, سيتم إنشاؤه.

مثال

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لإضافة نص جديد على النص الموجود في الملف 'a' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'a')

                    # لإضافة نص جديد في الملف الذي يشير إليه opened_file من الكائن write() هنا قمنا باستدعاء الدالة
                    opened_file.write('\nThis new text')

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•إذا قمت بتشغيل الملف Test.py و لم يحدث أي مشكلة, ستجد أن الملف demo.txt أضيف فيه النص "This new text" على سطر جديد.

Old text in the file. <-- إذا أفترضنا أن هذا النص كان موجوداً في الملف
This new text <-- سيتم إضافة السطر التالي في آخر الملف كالتالي

طريقة إنشاء ملف جديد في بايثون

تذكر: الرمز x الذي نضعه في الدالة open() يعتبر إختصار للكلمة Create, و هو يستخدم لإنشاء ملف جديد فقط في حال لم يكن موجوداً.

مثال

Test.py

                    # للإشارة إلى أننا نريد إنشاء هذا الملف في حال لم يكن موجوداً أصلاً 'x' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء ملف جديد إسمه
                    open('demo.txt', 'x')

•بعد تشغيل الملف Test.py سيتم إنشاء ملف فارغ إسمه demo.txt في نفس المشروع الذي نعمل فيه.
•في حال كان يوجد ملف إسمه demo.txt في نفس المشروع الذي نعمل فيه سيظهر لك الخطأ التالي.

FileExistsError: [Errno 17] File exists: 'demo.txt'

قراءة النص الموجود في ملف نصي في بايثون

تذكر: الرمز t الذي نضعه في الدالة open() يعتبر إختصار للكلمة Text, و هو يستخدم لتحديد أن محتوى الملف عبارة عن نص عادي.
كما أنه الـ Mode الإفتراضي للملف الذي تفتحه لهذا لا داعي لذكره إذا كنت ستتعامل مع ملف نصي.

مثال

Test.py

                    # لتحديد أن نوع الملف هو ملف نصي 't' للإشارة إلى أننا سنستخدم هذا الكائن للقراءة من الملف, و وضعنا الرمز 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'rt')

                    # الذي يشير للملف المفتوح حتى ترجع النص الموجود فيه, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
                    print(opened_file.read())

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم قراءة محتوى الملف demo.txt و من ثم عرضه كالتالي.

Python is an easy language to learn. <-- هنا افترضنا أن هذا النص كان موجوداً أصلاً في الملف

إنشاء نسخة من صورة أو فيديو في بايثون

تذكر: الرمز b الذي نضعه في الدالة open() يعتبر إختصار للكلمة Binary, و هو يستخدم لتحديد أن محتوى الملف عبارة عن Binary, أي أحرف لا يمكن أن يفهمها الإنسان العادي.
هذا الـ Mode نستخدمه عند التعامل مع الملفات الغير نصية مثل الصور, الفيدوهات, التسجيلات الصوتية إلخ..

ملاحظة: في المثال التالي إفترضنا أنك وضعت صورة في المشروع إسمها logo.png بجانب الملف Test.py.
لإضافة أي صورة في المشروع بشكل يدوية, يمكنك نسخ الصورة من حاسوبك و من ثم إلصاقها في المشروع ( Copy / Paste ).

مثال

Test.py

                    # و الذي يمثل الصورة التي نريد أن ننسخ محتواها 'logo.png' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    # لتحديد أننا نتعامل مع ملف غير نصي 'b' للإشارة إلى أننا سنستخدم هذا الكائن للقراءة من الملف, و وضعنا الرمز 'r' وضعنا الرمز 
                    existing_file = open('logo.png', 'rb')

                    # و الذي يمثل الصورة الجديدة التي سيتم إنشاءها و نسخ المحتوى فيها'logo-2.png' هنا قمنا بإنشاء كائن يشير لملف جديد إسمه
                    # لتحديد أننا نتعامل مع ملف غير نصي 'b' للإشارة إلى أننا سنستخدم هذا الكائن لكتابة في الملف بعد أن يتم إنشاؤه, و وضعنا الرمز 'w' وضعنا الرمز 
                    new_file = open('logo-2.png', 'wb')

                    # read() الذي يشير للصورة الأولى بواسطة الدالة existing_file هنا قمنا بقراءة محتوى الكائن 
                    # الذي يشير للصورة الثانية new_file و من ثم تخزين النص الذي ترجعه في الكائن 
                    new_file.write(existing_file.read())

                    # لإغلاق الإتصال مع الملفين المفتوحين في الذاكرة new_file و existing_file من الكائن close() هنا قمنا باستدعاء الدالة
                    existing_file.close()
                    new_file.close()

•بعد تشغيل الملف Test.py سيتم نسخة مطابقة من الصورة logo.png إسمها logo-2.png في نفس المشروع.

إنشاء كائن يسمح بالكتابة و القراءة من الملف في وقت واحد في بايثون

تذكر: الرمز a الذي نضعه في الدالة open() يعتبر إختصار للكلمتين Read & Write, و هو يستخدم لفتح الملف مع إمكانية القراءة منه و الكتابة فيه في نفس الوقت.

مثال

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لإضافة نص جديد على النص الموجود في الملف 'a' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'a+')

                    # لإضافة نص جديد في الملف الذي يشير إليه opened_file من الكائن write() هنا قمنا باستدعاء الدالة
                    opened_file.write('\nhis new text')

                    # للرجوع إلى أول حرف في الملف الذي يشير إليهopened_file من الكائن seek() هنا قمنا باستدعاء الدالة
                    opened_file.seek(0, 0)

                    # الذي يشير للملف المفتوح حتى ترجع النص الموجود فيه, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
                    print(opened_file.read())

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•إذا قمت بتشغيل الملف Test.py و لم يحدث أي مشكلة, ستجد أن الملف demo.txt أضيف فيه النص "This new text" على سطر جديد.
•كما أننا سنحصل على النتيجة التالية عند التشغيل.

Old text in the file. <-- إفترضنا أن هذا السطر كان موجود في الملف
This new text

الدالة `write() في بايثون`

تعريفها

تستخدم للكتابة في الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها.

بناؤها

                  write(string)

باراميترات

مكان الباراميتر string نمرر النص الذي نريد أن يتم كتابته في الملف.

قيمة الإرجاع

لا ترجع قيمة.

مثال

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لكتابة نص جديد في الملف 'w' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'w')

                    # لكتابة نص جديد في الملف الذي يشير إليه opened_file من الكائن write() هنا قمنا باستدعاء الدالة
                    opened_file.write('This new text will replace the old text.')

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم إنشاء ملف إسمه demo.txt في نفس المشروع الذي نعمل فيه و بداخله النص التالي.

This new text will replace the old text.

Python الدالة `writelines()`

تعريفها

تستخدم لكتابة مجموعة نصوص مخزنة في list في الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها.

بناؤها

                  writelines(aList)

باراميترات

مكان الباراميتر aList نمرر كائن list فيه مجموعة النصوص التي نريد أن يتم كتابتها بنفس الترتيب في الملف.

قيمة الإرجاع

لا ترجع قيمة.

مثال

Test.py

                    aList = ['text 1\n', 'text 2\n', 'text 3\n']

                    # للإشارة إلى أننا سنستخدم هذا الكائن لكتابة نص جديد في الملف 'w' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'w')

                    # في الملف الذي يشير إليه aList لكتابة قيم عناصر الكائن opened_file من الكائن writelines() هنا قمنا باستدعاء الدالة
                    opened_file.writelines(aList)

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم إنشاء ملف إسمه demo.txt في نفس المشروع الذي نعمل فيه و بداخله النص التالي.

text 1
text 2
text 3

Python الدالة `read()`

تعريفها

تستخدم للقراءة من الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها.
إذا قمت باستدعائها و لم تمرر لها أي رقم, سترجع كل النص الموجود في الملف دفعة واحد.

بناؤها

                  read(n = -1)

باراميترات

n هو باراميتر إختياري يمكنك أن تمرر مكانه رقم يمثل عدد الأحرف التي تريد قراءتها من الملف في حال لم ترد أن تقرأ كل محتوى الملف دفعة واحدة. مع الإشارة إلى أنك في كل مرة تقوم فيها باستدعائها ستعطيك الأحرف التالية الموجودة في الملف.

قيمة الإرجاع

ترجع النص الموجود في الملف.

في المثال التالي قمنا باستخدام الدالة read() لقراءة كل النص الموجود في الملف دفعة واحدة.

المثال الأول

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لقراءة النص الموجود في الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح حتى ترجع كل النص الموجود فيه, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
                    print(opened_file.read())

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم طباعة كل النص الموجود في الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه.

Python is an easy language to learn. <-- هنا افترضنا أن هذا النص كان موجوداً أصلاً في الملف

في المثال التالي قمنا باستخدام الدالة read() لقراءة خمسة أحرف من الملف في كل مرة نستدعيها فيها.

المثال الثاني

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لقراءة النص الموجود في الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح و في كل مرة جعلناها ترجع 5 أحرف جديدة. بعدها قمنا بطباعة هذه الأحرف opened_file أربع مرات من الكائن read() هنا قمنا باستدعاء الدالة
                    print(opened_file.read(5))
                    print(opened_file.read(5))
                    print(opened_file.read(5))
                    print(opened_file.read(5))

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py, في كل مرة يتم فيها إستدعاء الدالة read() سترجع الخمس أحرف التالية الموجودة في الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه.

Pytho
n is
an ea
sy la

Python الدالة `readline()`

تعريفها

تستخدم للقراءة سطراً سطراً من الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها.
إذا قمت باستدعائها و لم تمرر لها أي رقم, سترجع السطر التالي الموجود في الملف.

بناؤها

                  readline(limits = -1)

باراميترات

limits هو باراميتر إختياري يمكنك أن تمرر مكانه رقم يمثل عدد الأحرف التي تريد قراءتها من السطر التالي في الملف في حال لم ترد أن تقرأ كل محتوى السطر دفعة واحدة. مع الإشارة إلى أنك في كل مرة تقوم فيها باستدعائها ستعطيك الأحرف الموجودة حتى نهاية السطر الحالي في الملف.

قيمة الإرجاع

ترجع السطر التالي الموجود في الملف.

في المثال التالي قمنا باستخدام الدالة readline() لقراءة كل النص الموجود في الملف دفعة واحدة.

المثال الأول

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لقراءة النص الموجود في الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح لكي ترجع سطر جديد منه في كل مرة. بعدها قمنا بطباعة السطر الذي ترجعه opened_file ثلاث مرات من الكائن readline() هنا قمنا باستدعاء الدالة
                    print(opened_file.readline())
                    print(opened_file.readline())
                    print(opened_file.readline())

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم طباعة أول ثلاث أسطر موجودة في الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه.

First line

Second line

Third line

في المثال التالي قمنا باستخدام الدالة readline() لقراءة ستة أحرف موجودة على نفس السطر في الملف في كل مرة نستدعيها فيها.

المثال الثاني

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لقراءة النص الموجود في الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح و في كل مرة جعلناها ترجع 6 أحرف جديدة من السطر الحالي. بعدها قمنا بطباعة هذه الأحرف opened_file ثلاث مرات من الكائن readline() هنا قمنا باستدعاء الدالة
                    print(opened_file.readline(6))
                    print(opened_file.readline(6))
                    print(opened_file.readline(6))

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py, في كل مرة يتم فيها إستدعاء الدالة readline() سترجع الستة أحرف التالية الموجودة على نفس أسطر في الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه.

First
line

Second

Python الدالة `readlines()`

تعريفها

تستخدم لإرجاع نسخة من النص الموجود في الكائن الذي يمثل الملف المفتوح الذي قام باستدعائها ككائن list.
كل عنصر في كائن الـ list الذي ترجعه يمثل سطر موجود في الملف.
إذا قمت باستدعائها و لم تمرر لها أي رقم, سيتم وضع كل الأحرف الموجودة على كل سطر في الملف في عنصر من عناصر الكائن الـ list.

بناؤها

                  readlines(limits = -1)

باراميترات

limits هو باراميتر إختياري يمكنك أن تمرر مكانه رقم يمثل عدد الأحرف التي تريد قراءتها من كل سطر في الملف في حال لم ترد أن تقرأ كل محتوى السطر.

قيمة الإرجاع

ترجع نسخة من النص الموجود في ككائن list, كل عنصر فيه عبارة عن سطر في الملف.

في المثال التالي قمنا باستخدام الدالة readlines() لقراءة كل النص الموجود في الملف دفعة واحدة و إرجاعه ككائن list.

المثال الأول

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لقراءة النص الموجود في الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح لكي ترجعه ككائن opened_file من الكائن readlines() هنا قمنا باستدعاء الدالة
                    # كل عنصر فيه عبارة يحتوي على سطر من الأسطر الموجودة في الملف. بعدها قمنا بطباعته كما هو list
                    print(opened_file.readlines())

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم طباعة أول ثلاث أسطر موجودة في الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه.

['First line\n', 'Second line\n', 'Third line']

في المثال التالي قمنا بإنشاء حلقة for تعرض محتوى الملف سطراً سطراً.

المثال الثاني

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لقراءة النص الموجود في الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح لكي ترجعه ككائن opened_file من الكائن readlines() هنا قمنا باستدعاء الدالة
                    # كل عنصر فيه عبارة يحتوي على سطر من الأسطر الموجودة في الملف. بعدها قمنا بطباعته كما هو list
                    # و من ثم طباعة قيمته line و تخزين العنصر بشكل مؤقت في المتغير list بعدها قمنا بالمرور على كل عنصر في الكائن
                    for line in opened_file.readlines():
                    print(line)

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم طباعة كل سطر موجود في الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه.

First line

Second line

Third line

Python الدالة `tell()`

تعريفها

ترجع رقم آخر حرف في الملف تم الوصول إليه أثناء القراءة من الملف عن طريق الكائن الذي يمثل هذا الملف.

بناؤها

                  tell()

باراميترات

لا تقبل أي باراميتر.

قيمة الإرجاع

ترجع رقم آخر حرف في الملف تم الوصول إليه أثناء القراءة من الملف.

في المثال التالي قمنا باستخدام الدالة tell() في كل مرة قمنا فيها بقراءة بعض الأحرف من الملف.

مثال

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لقراءة النص الموجود في الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح حتى ترجع أول 5 أحرف موجودة في النص, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
                    print('Characters read:', opened_file.read(5))

                    # من جديد read() هنا قمنا بطباعة رقم آخر حرف في النص تم طباعته و الذي سيتم الطباعة من بعده عند استدعاء الدالة
                    print('Current file position:', opened_file.tell())

                    # الذي يشير للملف المفتوح حتى ترجع ثاني 5 أحرف موجودة في النص, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
                    print('Characters read:', opened_file.read(5))

                    # من جديد read() هنا قمنا بطباعة رقم آخر حرف في النص تم طباعته و الذي سيتم الطباعة من بعده عند استدعاء الدالة
                    print('Current file position:', opened_file.tell())

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py, في كل مرة يتم فيها إستدعاء الدالة read() سترجع الخمس أحرف التالية الموجودة في الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه.

Characters read: Self
Current file position: 5
Characters read: study
Current file position: 10

Python الدالة `seek()`

تعريفها

أثناء القراءة من الملف عن طريق الكائن الذي يمثل هذا الملف, يمكنك إستخدام هذه الدالة في حال أردت الرجوع إلى الوراء في الملف لقراءة الملف من جديد على سبيل المثال.

بناؤها

                  seek(offset, from_what=0)

باراميترات

from_what هو باراميتر إختياري يمكنك أن تمرر إحدى الأرقام التالية مكانه:

الرقم 0 إذا أردت الرجوع إلى أول حرف في الملف.
الرقم 1 إذا أردت البقاء عند حرف الحالي الذي وصلت إليه في الملف.
الرقم 2 إذا أردت الذهاب إلى آخر حرف في الملف.

مكان الباراميتر offset تمرر رقم يمثل بعد كم حرف نسبة للبراميتر from_what تريد أن تبدأ.

قيمة الإرجاع

لا ترجع قيمة.

في المثال التالي قمنا باستخدام الدالة seek() للعودة إلى أول الملف بعد أن كنا قد قمنا بقراءة بعد الأحرف منه.

مثال

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لقراءة النص الموجود في الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح حتى ترجع أول 10 أحرف موجودة في النص, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
                    print('Characters read:', opened_file.read(10))

                    # من جديد read() هنا قمنا بطباعة رقم الحرف الذي سيتم الطباعة من بعده عند استدعاء الدالة
                    print('Current file position:', opened_file.tell())

                    # و تمرير القيمتين 0 و 0 لها للرجوع إلى الحرف الأول في الملف opened_file من الكائن seek() هنا قمنا باستدعاء الدالة
                    opened_file.seek(0, 0)

                    # من جديد read() هنا قمنا بطباعة رقم الحرف الذي سيتم الطباعة من بعده عند استدعاء الدالة
                    print('Current file position:', opened_file.tell())

                    # الذي يشير للملف المفتوح حتى ترجع نفس الـ 10 أحرف السابقة, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
                    print('Characters read again:', opened_file.read(10))

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py, في كل مرة يتم فيها إستدعاء الدالة read() سترجع الخمس أحرف التالية الموجودة في الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه.

Characters read: Self study
Current file position: 10
Current file position: 0 <-- seek() الموقع 0 في الملف يعني أننا عدنا لأول الملف و هذا طبعاً حدث بسبب إستدعاء الدالة
Characters read again: Self study

Python الدالة `close()`

تعريفها

تستخدم لإغلاق الإتصال مع الملف و تنظيف الذاكرة من كل ما له علاقة بهذا الملف.
ملاحظة: في حال قمت بفتح الملف بالأساس بواسطة الجملة with فلا داعي لإغلاق الملف لأنها تقوم بإغلاقه بشكل تلقائي عنك.

بناؤها

                  close()

باراميترات

لا تقبل أي باراميتر.

قيمة الإرجاع

لا ترجع قيمة.

في المثال التالي قمنا باستخدام الدالة close() لإغلاق الملف المفتوح في الذاكرة بعد الإنتهاء من القراءة منه.

مثال

Test.py

                    # للإشارة إلى أننا سنستخدم هذا الكائن لقراءة النص الموجود في الملف 'r' و وضعنا الرمز 'demo.txt' هنا قمنا بإنشاء كائن يشير لملف إسمه
                    opened_file = open('demo.txt', 'r')

                    # الذي يشير للملف المفتوح حتى ترجع كل النص الموجود فيه, بعدها قمنا بطباعة النص الذي سترجعه opened_file من الكائن read() هنا قمنا باستدعاء الدالة
                    print(opened_file.read())

                    # لإغلاق الإتصال مع الملف المفتوح في الذاكرة opened_file من الكائن close() هنا قمنا باستدعاء الدالة
                    opened_file.close()

•بعد تشغيل الملف Test.py سيتم طباعة كل النص الموجود في الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه.

Python is an easy language to learn. <-- هنا افترضنا أن هذا النص كان موجوداً أصلاً في الملف

Python الدالة `rename()`

تعريفها

تستخدم لتغيير إسم الملف.

بناؤها

                  os.rename(current_file_name, new_file_name)

باراميترات

مكان الباراميتر current_file_name نمرر إسم الملف الذي نريد تغيير إسمه.
مكان الباراميتر new_file_name نمرر الإسم الجديد الذي نريد وضعه للملف.

قيمة الإرجاع

لا ترجع قيمة.

مثال

Test.py

                    # حتى نستطيع استخدام الدوال الموجودة فيه os هنا قمنا بتضمين الموديول
                    import os

                    # 'my-demo.txt' إلى 'demo.txt' لتغيير إسم الملف rename() هنا قمنا باستدعاء الدالة
                    os.rename('demo.txt', 'my-demo.txt')

•بعد تشغيل الملف Test.py سيتم تغيير إسم الملف demo.txt الذي إفترضنا أننا أنشأناه في نفس المشروع الذي نعمل فيه إلى my-demo.txt.

Python الدالة `remove()`

تعريفها

تستخدم لمسح الملف.

بناؤها

                  os.remove(file_name)

باراميترات

مكان الباراميتر file_name نمرر إسم الملف الذي نريد حذفه.

قيمة الإرجاع

لا ترجع قيمة.

مثال

Test.py

                    # حتى نستطيع استخدام الدوال الموجودة فيه os هنا قمنا بتضمين الموديول
                    import os

                    # 'demo.txt' لمسح الملف remove() هنا قمنا باستدعاء الدالة
                    os.remove('demo.txt')

•بعد تشغيل الملف Test.py سيتم مسح الملف demo.txt الذي إفترضنا أننا أنشأناه سابقاً في نفس المشروع.

Python الدالة `path.exists()`

تعريفها

تستخدم لمعرفة ما إن كان الملف موجوداً أم لا.

بناؤها

                  os.path.exists(file_name)

باراميترات

مكان الباراميتر file_name نمرر إسم الملف الذي نريد التأكد ما إن كان موجوداً أم لا.

قيمة الإرجاع

ترجع True إذا كان الملف موجوداً. و ترجع False إن لم يكن كذلك.

مثال

Test.py

                    # حتى نستطيع استخدام الدوال الموجودة فيه os هنا قمنا بتضمين الموديول
                    import os

                    # 'Test.py' موجوداً في نفس المكان الموجود فيه الملف 'demo.txt' لمعرفة ما إن كان الملف path.exists() هنا قمنا باستدعاء الدالة
                    os.path.exists('demo.txt')

•بعد تشغيل الملف Test.py سيتم طباعة القيمة True إذا كالتالي إذا كان عندك في نفس المشروع ملف إسمه demo.txt.
•إذا لم يتم إيجاد ملف إسمه demo.txt سيتم طباعة القيمة False.

Python الدالة `mkdir()`

تعريفها

تستخدم لإنشاء مجلد جديد.
معلومة: إسم الدالة هو إختصار لجملة Make Directory.

بناؤها

                  os.mkdir(directory_name)

باراميترات

مكان الباراميتر directory_name نمرر إسم المجلد الذي نريد إنشاؤه.

قيمة الإرجاع

لا ترجع قيمة.

مثال

Test.py

                    # حتى نستطيع استخدام الدوال الموجودة فيه os هنا قمنا بتضمين الموديول
                    import os

                    # 'images' لإنشاء مجلد إسمه mkdir() هنا قمنا باستدعاء الدالة
                    os.mkdir('images')

•بعد تشغيل الملف Test.py سيتم إنشاء مجلد إسمه images في نفس المشروع.

Python الدالة `rmdir()`

تعريفها

تستخدم لمسح المجلد.
ملاحظة: يمكنك حذف المجلد في حال كان فارغاً فقط, أي في حال لم يكن يحتوي على أي ملف بداخله.
معلومة: إسم الدالة هو إختصار لجملة Remove Directory.

بناؤها

                  os.rmdir(directory_name)

باراميترات

مكان الباراميتر directory_name نمرر إسم المجلد الذي نريد حذفه.

قيمة الإرجاع

لا ترجع قيمة.

مثال

Test.py

                    # حتى نستطيع استخدام الدوال الموجودة فيه os هنا قمنا بتضمين الموديول
                    import os

                    # 'images' لإنشاء مجلد إسمه rmdir() هنا قمنا باستدعاء الدالة
                    os.rmdir('images')

•بعد تشغيل الملف Test.py سيتم مسح مجلد إسمه images إفترضنا أنه كان موجود في نفس المشروع.

Python الدالة `getcwd()`

تعريفها

تستخدم لمعرفة إسم المجلد الذي تقف بداخله حالياً.
معلومة: إسم الدالة هو إختصار لجملة Get Current Working Directory.

بناؤها

                  os.getcwd()

باراميترات

لا تقبل أي باراميتر.

قيمة الإرجاع

ترجع المسار الذي تقف بداخله حالياً.

مثال

Test.py

                    # حتى نستطيع استخدام الدوال الموجودة فيه os هنا قمنا بتضمين الموديول
                    import os

                    # بعدها قمنا بطباعته .'Test.py' لترجع لنا إسم المجلد الموجود فيه الملف getcwd() هنا قمنا باستدعاء الدالة
                    print(os.getcwd())

•ستحصل على نتيجة تشبه النتيجة التالية عند التشغيل على حسب المسار الموجود فيه الملف Test.py على حاسوبك.

C:\Users\Mhamad\PycharmProjects\myapp

تعديل المقال

الأقسام بايثون Python

تعلم البرمجة مجانا

الملفات في بايثون |Python files

التعامل مع الملفات في بايثون

الدالة `open()` في بايثون

ملاحظة حول الملفات في بايثون

دوال القراءة و الكتابة في الملفات في بايثون

خصائص الملفات في بايثون

الموديول `os` في بايثون

البلوك `with` في بايثون

تخزين أحرف عربية في الملف في بايثون

التعامل مع الملفات بطريقة آمنة في بايثون

قراءة النص الموجود في ملف في بايثون

تخزين النص في ملف في بايثون

إضافة نص جديد على النص الموجود في ملف في بايثون

طريقة إنشاء ملف جديد في بايثون

قراءة النص الموجود في ملف نصي في بايثون

إنشاء نسخة من صورة أو فيديو في بايثون

إنشاء كائن يسمح بالكتابة و القراءة من الملف في وقت واحد في بايثون

الدالة `write() في بايثون`

Python الدالة `writelines()`

Python الدالة `read()`

Python الدالة `readline()`

Python الدالة `readlines()`

Python الدالة `tell()`

Python الدالة `seek()`

مثال

Python الدالة `close()`

Python الدالة `rename()`

Python الدالة `remove()`

Python الدالة `path.exists()`

Python الدالة `mkdir()`

Python الدالة `rmdir()`

Python الدالة `getcwd()`

مقالات قد تهمك

الملفات في بايثون |Python files

ملاحظة حول الملفات في بايثون

طريقة إنشاء ملف جديد في بايثون

إنشاء كائن يسمح بالكتابة و القراءة من الملف في وقت واحد في بايثون

Python الدالة writelines()

Python الدالة read()

Python الدالة readline()

Python الدالة readlines()

Python الدالة tell()

Python الدالة seek()

مثال

Python الدالة close()

Python الدالة rename()

Python الدالة remove()

Python الدالة path.exists()

Python الدالة mkdir()

Python الدالة rmdir()

Python الدالة getcwd()

مقالات قد تهمك

Python الدالة `writelines()`

Python الدالة `read()`

Python الدالة `readline()`

Python الدالة `readlines()`

Python الدالة `tell()`

Python الدالة `seek()`

Python الدالة `close()`

Python الدالة `rename()`

Python الدالة `remove()`

Python الدالة `path.exists()`

Python الدالة `mkdir()`

Python الدالة `rmdir()`

Python الدالة `getcwd()`