שפת C/הערות

מתוך ויקיספר, אוסף ספרי הלימוד והמדריכים החופשי.

הערות בשפה אנושית (לרוב אנגלית) בקוד יכולות לשפר את בהירותו.

[עריכה] הערות קלאסיות (מרובות שורה)

בשפת C אפשר לכתוב הערות כלשהן בין רצפי-התווים /* לבין */. לדוגמה:

/* This is a comment. */

המהדר מתעלם מכל מה שנמצא בין רצפי התווים הנ"ל.

הערות בסגנון זה יכולות להכיל יותר משורה יחידה:

/* This is a comment, but
it is not limited to a single line. It spans
multiple lines. */

[עריכה] הערות בסגנון החדש

באיזור שנת 2000 אימצה שפת C, בתקן C99, גם הערות "סגנון חדש", מהסוג הנהוג גם בC++‎. הערות אלה, המוגבלות כל אחת לשורה יחידה, מתחילות בתווים //, ונמשכות עד סוף השורה:

// This is a new-style single line comment.

שימו לב: לא כל המהדרים תומכים בהערות בסגנון החדש. ככל שמהדר ישן יותר, כך גדל הסיכון שהוא אינו תומך בכך.

[עריכה] השימוש בהערות

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

#include <stdio.h>
 
/* The program starts running here. */
int main()
{
  printf("Hello World\n");
  return 0;
}