C語言中文網 目錄
首頁 > 編程筆記 > C語言筆記 閱讀:27,115

C語言注釋詳解(兩種注釋方式)

在編寫C語言源代碼時,應該多使用注釋,這樣有助于對代碼的理解。在C語言中有兩種注釋方式:
  • 一種是以/*開始、以*/結束的塊注釋(block comment);
  • 另一種是以//開始、以換行符結束的單行注釋(line comment)。

可以使用/**/分隔符來標注一行內的注釋,也可以標注多行的注釋。例如,在下列的函數原型中,省略號的意思是 open() 函數有第三個參數,它是可選參數。注釋解釋了這個可選參數的用法:
int open( const char *name, int mode, … /* int permissions */ );
可以使用//插入整行的注釋,或者將源代碼寫成兩列分欄的格式,程序在左列,注釋在右列:
const double pi = 3.1415926536;       // pi是—個常量

在 C99 標準中,單行注釋正式加入C語言,但是大部分編譯器在 C99 之前就已經開始支持這種用法。有時候,其被稱作“C++風格”的注釋,但實際上,其源自于C的前身 BCPL。

在引號中,如果采用/*//分隔一個字符常量或字符串字面量(string literal),它們都不會被視為注釋的開始。例如,下面語句就沒有注釋:
printf("Comments in C begin with /* or //.\n" );
預處理器僅通過檢查注釋的結束符來檢測注釋中的字符,因此,不能嵌套塊注釋。然而,可以使用/**/注釋包含單行注釋的源代碼:
/* 暫時注釋掉這兩行:
    const double pi = 3.1415926536;  // pi是一個常量
    area = pi * r * r;   // 計算面積
暫時注釋到此 */

如果想要注釋掉包含塊注釋的部分程序,可以使用條件預處理命令:
#if 0
  const double pi = 3.1415926536;   /* pi是一個常量      */
  area = pi * r * r ;  /* 計算面積     */
#endif
預處理器會把每個注釋都替換成一個空格。因此,min/*max*/Value變成兩個標記min Value

精美而實用的網站,提供C語言C++STLLinuxShellJavaGo語言等教程,以及socketGCCviSwing設計模式JSP等專題。

Copyright ?2011-2018 biancheng.net, 陜ICP備15000209號

底部Logo