當前位置:首頁 » 編程語言 » c程序中注釋語言應放在什麼之間
擴展閱讀
webinf下怎麼引入js 2023-08-31 21:54:13
堡壘機怎麼打開web 2023-08-31 21:54:11

c程序中注釋語言應放在什麼之間

發布時間: 2023-05-10 00:19:03

1. c語言源程序的注釋說明位於什麼位置

開頭,中間都可以的這是比較常見的。它沒有固定的位置,只是有固定的寫法而已,下面會有列到。

原則上只要不破壞聲明和語句的意思和結構,放在哪裡都可以,但是注釋後將下一句分欄,就下面列舉的//這種類型,一般可以軟體中看到的,正常語句和注釋的顏色不一樣。

2. C語言程序注釋

C語言編程規范-注釋

規則:
1:一般情況下,源程序有效注釋量必須在20%以上。
說明:注釋的原則是有助於對程序的閱讀理解,在該加的地方都加了,注釋不宜太多也不能太少,注釋語言必須准確、易懂、簡潔。
2:說明性文件(如頭文件.h文件、.inc文件、.def文件、編譯說明文件.cfg等)頭部應進行注釋,注釋必須列出:版權說明、版本號、生成日期、作者、內容、功能、與其它文件的關系、修改日誌等,頭文件的注釋中還應有函數功能簡要說明。
示例:下面這段頭文件的頭注釋比較標准,當然,並不局限於此格式,但上述信息建議要包含在內。
/*************************************************
Copyright (C), 1988-1999, Tech. Co., Ltd.
File name: // 文件名
Author:
Version:
Date: // 作者、版本及完成日期
Description: // 用於詳細說明此程序文件完成的主要功能,與其他模塊
// 或函數的介面,輸出值、取值范圍、含義及參數間的控
// 制、順序、獨立或依賴等關系
Others: // 其它內容的說明
Function List: // 主要函數列表,每條記錄應包括函數名及功能簡要說明
1. ....
History: // 修改歷史記錄列表,每條修改記錄應包括修改日期、修改
// 者及修改內容簡述
1. Date:
Author:
Modification:
2. ...
*************************************************/
3:源文件頭部應進行注釋,列出:版權說明、版本號、生成日期、作者、模塊目的/功能、主要函數及其功能、修改日誌等。
示例:下面這段源文件的頭注釋比較標准,當然,並不局限於此格式,但上述信息建議要包含在內。
/************************************************************
Copyright (C), 1988-1999, Tech. Co., Ltd.
FileName: test.cpp
Author:
Version :
Date:
Description: // 模塊描述
Version: // 版本信息
Function List: // 主要函數及其功能
1. -------
History: // 歷史修改記錄
<author> <time> <version > <desc>
David 96/10/12 1.0 build this moudle
***********************************************************/
說明:Description一項描述本文件的內容、功能、內部各部分之間的關系及本文件與其它文件關系等。History是修改歷史記錄列表,每條修改記錄應包括修改日期、修改者及修改內容簡述。

4:函數頭部應進行注釋,列出:函數的目的/功能、輸入參數、輸出參數、返回值、調用關系(函數、表)等。
示例:下面這段函數的注釋比較標准,當然,並不局限於此格式,但上述信息建議要包含在內。

/*************************************************
Function: // 函數名稱
Description: // 函數功能、性能等的描述
Calls: // 被本函數調用的函數清單
Called By: // 調用本函數的函數清單
Table Accessed: // 被訪問的表(此項僅對於牽扯到資料庫操作的程序)
Table Updated: // 被修改的表(此項僅對於牽扯到資料庫操作的程序)
Input: // 輸入參數說明,包括每個參數的作
// 用、取值說明及參數間關系。
Output: // 對輸出參數的說明。
Return: // 函數返回值的說明
Others: // 其它說明
*************************************************/

5:邊寫代碼邊注釋,修改代碼同時修改相應的注釋,以保證注釋與代碼的一致性。不再有用的注釋要刪除。
6:注釋的內容要清楚、明了,含義准確,防止注釋二義性。
說明:錯誤的注釋不但無益反而有害。
7:避免在注釋中使用縮寫,特別是非常用縮寫。
說明:在使用縮寫時或之前,應對縮寫進行必要的說明。
8:注釋應與其描述的代碼相近,對代碼的注釋應放在其上方或右方(對單條語句的注釋)相鄰位置,不可放在下面,如放於上方則需與其上面的代碼用空行隔開。
示例:如下例子不符合規范。

例1:
/* get replicate sub system index and net indicator */

repssn_ind = ssn_data[index].repssn_index;
repssn_ni = ssn_data[index].ni;
例2:
repssn_ind = ssn_data[index].repssn_index;
repssn_ni = ssn_data[index].ni;
/* get replicate sub system index and net indicator */
應如下書寫
/* get replicate sub system index and net indicator */
repssn_ind = ssn_data[index].repssn_index;
repssn_ni = ssn_data[index].ni;
9:對於所有有物理含義的變數、常量,如果其命名不是充分自注釋的,在聲明時都必須加以注釋,說明其物理含義。變數、常量、宏的注釋應放在其上方相鄰位置或右方。
示例:
/* active statistic task number */
#define MAX_ACT_TASK_NUMBER 1000

#define MAX_ACT_TASK_NUMBER 1000 /* active statistic task number */
10:數據結構聲明(包括數組、結構、類、枚舉等),如果其命名不是充分自注釋的,必須加以注釋。對數據結構的注釋應放在其上方相鄰位置,不可放在下面;對結構中的每個域的注釋放在此域的右方。
示例:可按如下形式說明枚舉/數據/聯合結構。
/* sccp interface with sccp user primitive message name */
enum SCCP_USER_PRIMITIVE
{
N_UNITDATA_IND, /* sccp notify sccp user unit data come */
N_NOTICE_IND, /* sccp notify user the No.7 network can not */
/* transmission this message */
N_UNITDATA_REQ, /* sccp user's unit data transmission request*/
};
11:全局變數要有較詳細的注釋,包括對其功能、取值范圍、哪些函數或過程存取它以及存取時注意事項等的說明。
示例:
/* The ErrorCode when SCCP translate */
/* Global Title failure, as follows */ // 變數作用、含義
/* 0 - SUCCESS 1 - GT Table error */
/* 2 - GT error Others - no use */ // 變數取值范圍
/* only function SCCPTranslate() in */
/* this moal can modify it, and other */
/* mole can visit it through call */
/* the function GetGTTransErrorCode() */ // 使用方法
BYTE g_GTTranErrorCode;
12:注釋與所描述內容進行同樣的縮排。
說明:可使程序排版整齊,並方便注釋的閱讀與理解。
示例:如下例子,排版不整齊,閱讀稍感不方便。
void example_fun( void )
{
/* code one comments */
CodeBlock One

/* code two comments */
CodeBlock Two
}

應改為如下布局。
void example_fun( void )
{
/* code one comments */
CodeBlock One

/* code two comments */
CodeBlock Two
}
13:將注釋與其上面的代碼用空行隔開。
示例:如下例子,顯得代碼過於緊湊。
/* code one comments */
program code one
/* code two comments */
program code two

應如下書寫
/* code one comments */
program code one

/* code two comments */
program code two
14:對變數的定義和分支語句(條件分支、循環語句等)必須編寫注釋。
說明:這些語句往往是程序實現某一特定功能的關鍵,對於維護人員來說,良好的注釋幫助更好的理解程序,有時甚至優於看設計文檔。
15:對於switch語句下的case語句,如果因為特殊情況需要處理完一個case後進入下一個case處理,必須在該case語句處理完、下一個case語句前加上明確的注釋。
說明:這樣比較清楚程序編寫者的意圖,有效防止無故遺漏break語句。
示例(注意斜體加粗部分):
case CMD_UP:
ProcessUp();
break;

case CMD_DOWN:
ProcessDown();
break;

case CMD_FWD:
ProcessFwd();

if (...)
{
...
break;
}
else
{
ProcessCFW_B(); // now jump into case CMD_A
}

case CMD_A:
ProcessA();
break;

case CMD_B:
ProcessB();
break;

case CMD_C:
ProcessC();
break;

case CMD_D:
ProcessD();
break;
...
建議:
1:避免在一行代碼或表達式的中間插入注釋。
說明:除非必要,不應在代碼或表達中間插入注釋,否則容易使代碼可理解性變差。
2:通過對函數或過程、變數、結構等正確的命名以及合理地組織代碼的結構,使代碼成為自注釋的。
說明:清晰准確的函數、變數等的命名,可增加代碼可讀性,並減少不必要的注釋。
3:在代碼的功能、意圖層次上進行注釋,提供有用、額外的信息。
說明:注釋的目的是解釋代碼的目的、功能和採用的方法,提供代碼以外的信息,幫助讀者理解代碼,防止沒必要的重復注釋信息。
示例:如下注釋意義不大。
/* if receive_flag is TRUE */
if (receive_flag)

而如下的注釋則給出了額外有用的信息。
/* if mtp receive a message from links */
if (receive_flag)
4:在程序塊的結束行右方加註釋標記,以表明某程序塊的結束。
說明:當代碼段較長,特別是多重嵌套時,這樣做可以使代碼更清晰,更便於閱讀。
示例:參見如下例子。
if (...)
{
// program code

while (index < MAX_INDEX)
{
// program code
} /* end of while (index < MAX_INDEX) */ // 指明該條while語句結束
} /* end of if (...)*/ // 指明是哪條if語句結束
5:注釋格式盡量統一,建議使用"/* …… */"。
6:注釋應考慮程序易讀及外觀排版的因素,使用的語言若是中、英兼有的,建議多使用中文,除非能用非常流利准確的英文表達。
說明:注釋語言不統一,影響程序易讀性和外觀排版,出於對維護人員的考慮,建議使用中文。

3. 在C語言中說明語句必須位於什麼

說明只能位於一條語句的後面注釋可以隨處良好的注釋說明,一般建議是寫在語句的上面。

C語言的數組長度一經聲明,長度就是固定,無法改變,並且C語言並不提供計算數組長度的方法。

由於C語言是沒有檢查數組長度改變或者數組越界的這個機制,可能會在編輯器中編譯並通過,但是結果就不能肯定了,因此還是不要越界或者改變數組的長度。

C語言中的變數,按作用域范圍可分為兩種,即局部變數和全局變數。

介紹

局部變數也稱為內部變數。局部變數是在函數內作定義說明的。其作用域僅限於函數內, 離開該函數後再使用這種變數是非法的。在復合語句中也可定義變數,其作用域只在復合語句范圍內。

全局變數也稱為外部變數,它是在函數外部定義的變數。它不屬於哪一個函數,它屬於一個源程序文件。其作用域是整個源程序。

4. c語言中的注釋不可以加在變數名或關鍵字的中間 這句話對嗎

對。不可以加在變擾頃量名或關鍵字瞎和的中間,但可以加磨李盯在兩個變數名或關鍵字的中間。
int /*註解*/ data; 沒問題
i /*註解*/nt data;就不行了

5. (3) 在C程序中,注釋必須單獨佔一行,不能放在語句的後面。 這句話對嗎

編程習慣和公司規定而已。有人喜歡注釋單獨一行,有人喜歡在語句後注釋。
一般來說,函數的注釋要寫在函數上面。變數注釋可以單獨一行,也可以寫到變數聲明後。

6. c程序中的注釋可以出現在程序的哪裡

任何位置。c程序中的注釋部逗祥陪分對程序的運行結果不產生任何影響,它可以出現在程序的任何位置。c程序即用C語言編寫的程序,具有繪圖能力強,可移植性強,宴族並山蠢具備很強的數據處理能力,適於編寫系統軟體。

7. c語言中可以對程序進行注釋,注釋部分如果佔多行,必須以什麼開始

以注釋內容開始。
關於程序中注釋書寫格式
1程序文件注釋:
放在程序名稱空間引用(using System.IO;)的上面,主要寫公司的版權、文件創建的時間、文件的主要內容、文件的名字、文件的創建標識(創建人姓名)、文件修改的時間、文件修改時的修改標識(修改人姓名)、文件修改的修改原因等(詳情見文檔後備注示例);
2類的作用注釋:
放在類(類、介面、枚舉、結構體)的聲明上方,主要描述類的作用。
如果類的結構比較復雜,也應該添加類的使用示例和類的流程(其它特點)
3、類的私有全局重要變數注釋:
放在類的全局變數聲明上方,主要需要注釋通過命名不能正確理解的全局私有或公有(包含受保護等)變數。如果是object(特殊數組等)型變數,內部使用時結構比較復雜或有規定,需要簡要的說明一下內部結構。
4、類的屬性的注釋:
放在類的屬性聲明上方,簡要說明屬性的類型和主要作用。
5、類的公有方法的注釋:
主要說明方法的作用,方法各參數的意義和要求,方法的返回值及各種可能的返回值的特殊意義,方法可能會產生的異常,如果需要,則可以寫出方法的使用示例;
6、類的私有方法或重要演算法的注釋:
除了需要說明公有方法所要求的之外,如果演算法、數學運算比較復雜,需要寫出演算法或數學方法的理論過程或推導過程;如果演算法比較長,要盡可能的細分成邏輯塊,並填寫適當的注釋;對於方法中的重要變數也要添加適當的注釋,特別是對方法的結果或方法某一段的結果的方法內部不易理解的變數要添加合適的注釋;對於特別復雜(重要)的方法,要添加適當的流程圖或文檔,給以充分的文字、圖解等說明;
7、文件、類或類的方法修改後的注釋的變更:
對於對文件或類(包括介面、枚舉、結構體)或類的方法修改後,要添加修改後的相注釋,要寫清修改的時間、修改標識(修改人姓名)、修改的原因等一切必要的信息和一切必要變更的信息(類、方法的流程);

8. c程序中注釋的內容應放在什麼和什麼符號之間

放在//後面
或者/*……*/之間

9. 在c程序中,注釋說明只能位於一條語句的後面

C程序的基本組成單位是函數D)注釋說明只能位於一條語句的後面,最佳答案D注釋說明只能位於一條語句的後面注釋可以隨處良好的注釋說明,一般 建議是寫在語句的上面。

C++是一種面向對象的計算機程序設計語言,由美國AT&T貝爾實驗室的本賈尼·斯特勞斯特盧普博士在20世紀80年代初期發明並實現。

最初它被稱作「C with Classes」(包含類的C語言)兆租。它是一種靜態數據類型檢查的族滑兆、支持多重編程範式的通用程序設計語言,支持過程化程序設計、數據抽象、面向對象程序設計、泛型程序設計等多種程序設計風格。

C++是C語言的繼承,進一步擴讓數充和完善了C語言,成為一種面向對象的程序設計語言。