בעולם התכנות, בניגוד לשיעורי היסטוריה בתיכון, אנחנו שמים דגש על היכולות השונות של המתכנת ופחות על הזיכרון שלו בנוגע לפרטים קטנים.
אומנם מרשים לראות מתכנת ששולט היטב בכל רזי שפת תכנות מסוימת, אבל בעולם האמיתי כולנו משתמשים באתרים שמטרתם לסייע לנו, בין אם להבין איך לכתוב את הקוד בצורה יעילה ובין אם כדי להיזכר בפונקציה או בפעולה ששכחנו.
לרוב שפות התכנות או המערכות המוכרות שבהן תתעסקו, יש מעין "מדריך למשתמש" שנקרא תיעוד, או דוקומנטציה.
ככל שהמוצר שאתם משתמשים בו בשל יותר ויש לו משתמשים רבים, כך תוכלו למצוא עבורו תיעוד מפורט וברור יותר.
תיעוד טוב הוא לעיתים רבות שיקול מכריע בהחלטה אם להשתמש בטכנולוגיה מסוימת או לא.
לא אחת אפילו מתכנתים מעולים ומנוסים נעזרים בתיעוד ובאמצעים מקבילים במשך עבודתם.
לפייתון יש אתר תיעוד מרשים ומלא במידע. רוב המידע המתועד באתר כתוב בצורה טובה ונהירה.
באתר ישנה תיבת חיפוש, ואפילו מדריך כניסה עבור מתחילים, שמתבסס על ידע מסוים בתכנות.
רוב מתכנתי הפייתון משתמשים באתר התיעוד הזה כמדריך עזר, ופונים אליו כשהם צריכים פרטים נוספים בקשר לרעיון שכבר קיים אצלם בראש.
בשיעור הקודם למדנו שלכל סוג נתונים (כמו str או int) יש פעולות ששייכות לו.
עבור מחרוזות, לדוגמה, אנחנו מכירים פעולות כמו str.count ו־str.replace.
כדי לקבל את רשימת הפעולות עבור סוג נתונים מסוים נשתמש בפונקציה dir():
In [ ]:
dir(str)
התוצאה היא רשימה של כל הפעולות שאפשר להפעיל על str.
בשלב הזה, אמליץ לכם להתעלם מפעולות ברשימה ששמן מתחיל בקו תחתון.
טריק נוסף שכנראה נוח יותר, זמין בסביבות פיתוח רבות שיצא לכם לעבוד בהן.
הטריק הוא ציון סוג הנתון או המשתנה שאתם עובדים עליו, הסימן "נקודה" ואז לחיצה על ↹ TAB.
In [ ]:
# מקמו את הסמן אחרי הנקודה, ואז לחצו על המקש "טאב" במקלדת
str.
# ניתן גם כך:
"Hello".
# או כך:
s = "Hello"
s.
במקרה שנרצה לחפש פרטים נוספים על אחת הפונקציות או הפעולות (נניח len, או str.upper()), התיעוד של פייתון הוא מקור מידע נהדר לכך.
אם אנחנו נמצאים בתוך המחברת, יש טריק נחמד לקבל חלק מהתיעוד הזה בצורה מהירה – פשוט נרשום בתא קוד את שם הפונקציה, ואחריו סימן שאלה:
In [ ]:
len?
ברגע שנריץ את התא, תקפוץ לנו חלונית עם מידע נוסף על הפונקציה.
אם אנחנו רוצים לקבל מידע על פעולה, נכתוב את סוג הערך שעליו אנחנו רוצים לבצע אותה (נניח, str):
In [ ]:
# str - השם של טיפוס הנתונים (הסוג של הערך)
# . - הנקודה היא סימון שהפעולה שכתבנו אחריה שייכת לסוג שכתבנו לפניה
# upper - השם של הפעולה שעליה רוצים לקבל עזרה
# ? - מבקש את המידע על הפעולה
str.upper?
קריאה לפונקציה, קרי הוספת התווים () לפני סימן השאלה, תפעיל את הפונקציה או הפעולה במקום לתת לכם עזרה.
בתוך חלונית העזרה שתיפתח במחברת נראה שורות המכילות פרטים מעניינים:
לעת עתה, נתעלם מהרכיבים self, * או / שיופיעו מדי פעם בשדה Signature.
עולם התכנות הוא אדיר בממדיו, וקיימים משאבים נהדרים שמטרתם לעזור למתכנת.
לפניכם כמה מהפופולריים שבהם:
בתרגול זה השתמשו במידת הצורך בתיעוד של פייתון כדי לגלות פעולות שלא למדנו עליהן.
לפניכם רשימת המספרים הטבעיים מ־1 עד 10 בסדר מבולבל.
האם תוכלו לסדר אותה בשורה אחת של קוד, ולהדפיס אותה בשורה אחת נוספת?
הפלט שיודפס על המסך צריך להיות: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10].
In [ ]:
numbers = [2, 9, 10, 8, 7, 4, 3, 5, 6, 1]
שיטת דיואי משמשת לחלוקת ספרים לתחומי תוכן.
כך, קטגוריה 000 המכילה ספרות כללית הנוגעת למדעי המחשב, מידע ועבודות כלליות, 500 היא ספרות הנוגעת למדע טהור ו־700 היא ספרות הנוגעת לאומנות.
בתוך כל קטגוריה יש תתי־קטגוריות נוספות, כמו 004 שמתעסקת בעיבוד מידע, 005 שמתעסקת בתכנות, או 755 שמתעסקת באומנות בדת.
קבלו מהמשתמש שם ספר, ואת הקטגוריה שאליה הוא משתייך.
אם משתמש הקליד מספר שאינו בעל 3 ספרות, כמו "4", הניחו שהמשתמש התכוון להקליד 004 והשלימו עבורו את המלאכה.
הדפיסו למשתמש את מספר הקטגוריה אחרי התיקון, או "קטגוריה שגויה" אם הקלט שהוזן לא היה מספרי.
לדוגמה:
In [ ]: