בחירת שמות לאובייקטים ומשתנים

‏ • 27 בנובמבר, 2003

בכדי ליעל את צורת העבודה מומלץ מאוד לקבוע שמות בעלי משמעות שיתארו את מהות האובייקט או המשתנה. נכון, אפשר לקרוא לו בשמות I ו f, אך בכדי להבין את המשמעות וגם שאחרים יוכלו להבין מומלץ לכתוב בצורה הבאה:

הכללים המקובלים (והמחייבים) :

  • התו הראשון חייב להיות אות (a-z , A-Z).
  • השם יכול להיות מחרוזת תווים, החל באות אחת ועד עשרות תווים.
  • התווים יהיו אך ורק באותיות האלף בית הלועזיות (a-z, A-Z), בספרות (0-9) ובשני תווים מיוחדים, שהם _ ו- $.
  • אסור להשתמש ברווח (space character).
    אסור להשתמש במילות שמורות (https://webmaster.org.il/article.asp?id=4)

כאשר הנך נותן לאובייקט שם, כתוב את השם בשפה האנגלית. מכוון שבעתיד גם לך ולא רק לאחרים יהיה קושי לקרוא ולהבינו (לדוגמא : כתוב – myFile ולא hchevzimShli). השתדל לצמצם את שם האובייקט ולתת לו שם שתוכל לעבוד ולהבין את תפקידו בתוכנית (לדוגמא: כתוב- picMenuMsg ולא- pictureMenuMessage). השתדל שהשמות לא יהיו ארוכים מידי (למרות שאין מגבלה למספר התווים של שם אובייקט).

להלן כמה שיטות כתיבה לשמות :

Formatted compound words :

כל אות ראשונה היא תהיי אות ראשית.

דוגמא : MyPic ו FindHeightInMeters.

בצורה שונה של השיטה Formatted compound words

המילה הקטנה תמיד תהיי באות קטנה ולאחר מכן כל אות ראשונה במילה תהי באות ראשית.

לדוגמא : myPic ו findHeightInMeters.

On end on :

מילה ראשונה תהיי באותיות ראשיות ומלה שניה באותיות קטנות, וכן אלאה ולהפך.

MYpic או myPIC .

השיטה ההונגרית (Hungarian convention) :

הוספת קידומות לפני שם האובייקט, כאר הקידומת מציינת את סוגו של האובייקט. לדוגמא לאובייקט image הוסף את הקידומת img או pic או לאובייקט link (שנוצר ע"י התגית ) השתמש בקידומת lnk.

לדוגמא : imgHomePage , picLogo ו lnkIndexPage.

הפרדת מילים בעזרת קו תחתי :

יש המפרידים בין מילה למילה בעזרת קו תחתי ( _ ).

לדוגמא : my_pic ו find_height_in_meters.

לא משנה באיזה שיטה או דרך תשתמש העיקר שתהיי עקבי ותבין את מה שאתה עושה.

מקווה שנתתי יד לייעול קטן מאוד בכתיבת התסריט.

בהצלחה !!!

 

תגיות: , ,

תגובות בפייסבוק