הצגת המקור של הדף "פייתון/פייתון גרסה 3/קריאה וכתיבה של מסמכים"


{{פייתון/פייתון גרסה 3}}
==הקדמה==
בפרק זה נקרא על קריאה וכתיבה של מסמכים הידועה בשם input (בקיצור: I) ו-output (בקיצור:O) 
ניתן לקרוא באמצעות פייתון קבצים שונים של טקסט וקידודים קיימים. נזדקק לפעולה זו בשביל: 
# לבצע פעולות על קובץ נתונים מסוים בקלות ונוחות.
# חסכון בזכרון.
# מניעה מכל אדם לערוך קבצי קידוד.
# להריץ רק קידודים קיימים.
# מסמכים שומרים על התוכן שלהם לכן אם אירעה תקלה בעת הקלדת הקידוד, כל המסמכים שמורים במערכת.
# יצירת קבצים שונים כמו תמונות, מסמכים ועוד. 
# זמינות של קבצים לצפייה על ידי תוכנה אחרת.

== תנאים בסיסים ==
כאשר נרצה לקרוא קובץ באמצעות פייתון :
# נכניס לאותה תיקיה את קובץ הפייתון שיקרא את המסמך ואת המסמך עצמו.
# מומלץ לשמור בתיקיה עם שם באנגלית מאחר שפייתון מתקשה או עושה בעיות עם קריאת טקסטים בעברית.
# שם הקובץ צריך להיות ללא רווח ואם נרצה להפריד בין מילים נעזר בקו תחתון. 

בכדי להקל על ההסבר מומלץ להכין שני קבצים:
# צרו '''[[פייתון/פייתון גרסה 3/עבודה אינטראקטיבית או קובץ אצווה|קובץ אצווה]]''' חדש ושמרו אותו בתיקיה עם שם באנגלית. 
# צרו קובץ כתבן תחת השם "otto" המכיל את הכיתוב:

<source lang = "python">

Otto I, traditionally known as Otto the Great, was German king .
He was the oldest son of Henry I the Fowler and Matilda.
</source>

==פתיחה וסגירה של קובץ==
# פונקצית  <code> open</code>  ו-<code>close</code>. 
# <code>with open </code> 

שתי הפונקציות קוראות לפייתון לקבל נתונים ממסמך. 

{| class="wikitable"
|-
! פונקצית <code> open</code> !! <code>with open </code> 
|-
| חייבים לקרוא לסגירת הפונקציה באמצעות פונקצית <code>close</code>

אי סגירה של פונקצית  <code>open()</code>, במצב של כתיבה, למשל, כפי שנראה, תגרום לכך שפייתון תמשיך לבצע שינויים על מסמך ועלולה לפגוע בתוכנו.

| אין צורך לקרוא לסגור את הקובץ 

|-
| שורה של פקודות || שורה מוזחת של פקודות 
|-
|<source lang = "python">
open('<variables>.<filename>','<mode>')

variables.close()
</source>
|<source lang = "python">
with open('<filename>','<mode>') as <variables>:
    ...
</source>

|}

* variables - משתנה בו נכנה את פעולת הקריאה.
* filename - שם הקובץ. 
**העדפה - אם הקובץ והמסמך נמצאים באותה תיקיה, ניתן לרשום ב-filename את שם הקובץ (כולל סיומת של סוג הקובץ). אנו נתעדף לכנות שם בשם הקובץ לבדו כך שכל משתמש יכול להוריד את הקבצים לתיקיה במחשב ולהריץ אותם.
**אם הקבצים בשתי תיקיות שונות נוכל לרשום את נתיב הקובץ. 
*mode

==Mode==
{| class="wikitable" align="left"
|-
!mode !! r+!! r !! w !!w+ !! a!!a+
|-
| קריאה || + || + ||  || + ||  || +
|-
| כתיבה || || + || + || + || + || +
|-
|קריאה אחרי חיפוש ||  || + || + || + ||  || 
|-
| יצירת קובץ במידה ואינו קיים ||  ||  || + || + ||  + ||  +
|-
| דריסת קובץ קיים ||   ||  || + || + ||  || 
|-
| מיקום תו בהתחלה || + || + || + || + || ||  
|-
| מיקום תו בסוף ||  || || || || + || +
|}
{| class="wikitable"
|-
|dir="ltr"| R+ || קריאה וכתיבה, בעיקר עדכון. כתיבה מהתו הראשון.
|-
| R || קריאה בלבד מתחילת הקובץ.
|-
| W || דריסה או יצירה חדשה של קובץ עבור כתיבה מהתו הראשון של הקובץ.
|-
|w+ || דריסה או יצירה חדשה של קובץ עבור כתיבה וקריאה מהתו הראשון של הקובץ.
|-
| A || כתיבה מהתו האחרון
|-
| A+ ||כתיבה וקריאה מהתו האחרון
|-
|colspan="2"|מצב בינארי
|-
|dir="ltr"| rb+ || קריאה וכתיבה, בעיקר עדכון. כתיבה מהתו הראשון.
|-
|dir="ltr"|rb || קריאה בלבד מתחילת הקובץ.
|-
|dir="ltr"|wb || דריסה או יצירה חדשה של קובץ עבור כתיבה מהתו הראשון של הקובץ.
|-
|dir="ltr"|wb+ || דריסה או יצירה חדשה של קובץ עבור כתיבה וקריאה מהתו הראשון של הקובץ.
|-
|dir="ltr"|ab || "תו הקריאה והכתיבה" (iterator) נמצא מיד אחרי התו האחרון (ללא רווח)
|-
|dir="ltr"| ab+ ||"תו הקריאה והכתיבה" (iterator) נמצא מיד אחרי התו האחרון (ללא רווח)
|}
סגירה של פונקצית  <code>open()</code> במצבים השונים חשובה. אם לא נסגור את הפונקציה, במצב של כתיבה, פייתון תמשיך לבצע שינויים על המסמך ועלולה לפגוע בתוכנו, אם מדובר על קובץ מקודד.

===מה סוג הקובץ? ומה נתיבו?===
נתיבו של קובץ נמצא בשורת הניתוב של המסמכים. ניתן למצוא את ניתב הקובץ וסוג גם על ידי:
# לחיצה על מקש שמאלי של הקובץ
#מאפיינים 
# בלשונית כללי קיימת שורה של סוג הקובץ ומיקום (בו מופיע הנתיב המלא)

===דוגמה===
בכדי להדגים כיצד קוראים לפייתון לקרוא או לכתוב מסמכים נעזר בפונקצית <code>read()</code> ובפונקצית  <code>closed()</code>. 

הפונקציה הראשונה מאפשרת לקרוא תווים מתוך מסמך. כאשר בסוגריים נרשם את מספר התו האחרון שנרצה כי פייתון תקרא.

הפונקציה השנייה ממחזירה ערך בולייאנים המציין האם הפונקציה נסגרה או לא. 

<source lang = "python">
#function: open
f = open('otto.txt','r')

print(f.read(4))
print(f.read(123))

f.close()

print(f.closed)

#function: with open
with open('otto.txt','r') as t:
    print(t.read(200))

print(t.closed)
</source>

הפלט:
<source lang = "python">

Otto
 I, traditionally known as Otto the Great, was German king .

True
Otto I, traditionally known as Otto the Great, was German king .

True
</source>

==<math>Mode \ r+</math>==
נעזר בפונקציות חדשות:
# <code>readlines() </code> - פונקציה הקוראת את כל שורות המסמך.
# <code>write() </code> - הפונקציה הכותבת אל הטקסט.

נמחק את הפקודות מקובץ האצווה שלנו בפייתון ונפתח במצב r+:
<source lang = "python">
with open('otto.txt','r+') as f:
    f.write('After putting down a brief civil war among the rebellious duchies\n')
    print(f.readlines())
</source>

נבצע הרצה '''אחת''' בלבד :
<source lang = "python">
['Otto I, traditionally known as Otto the Great, was German king .\n']  
</source>

נפתח את קובץ הכתבן "otto" מחדש ונשם לב לשורה האחרונה שנוספה למסמך. 

מדוגמה זו ניתן להבין את החשיבות בסגירת פונקצית  <code>open() </code>. אם לא נסגור את הפונקציה כל הפוקדות שנמשיך לפקוד על פייתון לבצע, יתבצעו בקובץ המקורי שלנו. במקרה זה אנו נמצאים במצב <math>r+</math> ולכן הנתונים נוספים אל סוף הטקסט.

==<math>Mode \ r</math> ו-<math>Mode \ w</math>==

אם היינו במצב <math>r</math> הינו מקבלים הודעת שגיאה <math>not \ readable</math> :

<source lang = "python">
Traceback (most recent call last):
  File "C:/Users/user/Desktop/python/reading and writing files.py", line 2, in <module>
    f.write('He was the oldest son of Henry I the Fowler and Matilda.')
io.UnsupportedOperation: not writable
</source>

אם הינו במצב w היינו מקבלים גם שגיאה.
<source lang = "python">

Traceback (most recent call last):
  File "C:/Users/user/Desktop/python/reading and writing files.py", line 3, in <module>
    print(f.readlines())
io.UnsupportedOperation: not readable
</source>
פייתון אינה יכולה להפעיל את פונקצית read כי לא ניתן לקרוא מהמסך במצב זה. אם נפתח את המסמך נשם לב כי פייתון כן בצעה את הפעולה הראשונה של גריסה ועל כן נותרנו עם שורה אחת "He was the oldest son of Henry I the Fowler and Matilda."

==יצירה ודריסה של קובץ==
ננסה לפתוח קובץ שאינו קיים:
<source lang = "python">

with open('text.txt','r') as f:
     print(f.readlines())
>>>  File "C:\Users\user\Desktop\python\reading and writing files.py", line 1, in <module>
    with open('text.txt','r') as f:
FileNotFoundError: [Errno 2] No such file or directory: 'text.txt'

</source>
קבלנו הודעת שגיאה כי הקובץ אינו קיים. 

בחלק מהמצבים פייתון תיצור קובץ חדש תחת שם זה, למשל:

<source lang = "python">

with open('text.txt','w+') as f:
     print(f.readlines())
   
>>>[]
</source>

פייתון הדפיסה לנו סוגריים ריבועים מפני שהיא יצרה קובץ חדש בתיקייה. הקובץ הזה ריק ובשל כך קבלנו את ההדפסה הנדונה.

אם הקובץ איננו ריק, פיתון תדרוס אותו במצב "W" ותייצר חדש עם כל הפקודות שייצרנו.    
<source lang = "python">

with open('otto.txt','w+') as f:
     f.write('hello')
</source>
   
נפתח את קובץ "otto" ונראה כי נותר בו רק הכיתוב "hello". 

כל המצבים השונים של יצירה, דריסה ועוד מסוכמים בטבלה בראשית העמוד.

==מצב בינארי==
מצב בינאר, באופן פשטני, הוא מצב בו פייתון מתרגם תו ומפרש אותו בהתאם ל"קידודים" אותם מכיר פייתון. 

דוגמה, ניצור מסמך עם הכיתוב:

<source lang = "python">
He was the oldest son of Henry I the Fowler and Matilda.first.



0123456789abcdeft 
</source>

נדפיס בקובץ האצווה את הכיתוב:
<source lang = "python">
with open('otto.txt','rb+') as f:
     print(f.readlines())

>>>[b'He was the oldest son of Henry I the Fowler and Matilda.first.\r\n', b'\r\n', b'\r\n', b'\r\n', b'0123456789abcdeft '] 
</source>
כפי שניתן לראות פייתון תרגמה את הרווחים במסמך והמירה אותם לכיתוב-\n. 
*  הוא סימון עבור ASCII ובשל זה אין לנו עניין בו.
* b מסמן את המצב הבינארי.
 
בשלב זה אין לנו עניין במצב זה ולכן לא נעמיק בכל תו ותו בו. 

===ראה גם ===
* [[פייתון/פייתון גרסה 3/רשימת פונקציות מערכת built-in/פונקציות קלט ופלט של מסמכים|סיכום פונקציות קלט ופלט של מסמכים]]
===מקורות חיצונים===
* [https://docs.python.org/3/tutorial/inputoutput.html באתר פייתון]
[[קטגוריה:פייתון גרסה 3]]