c語言的書寫規則

『壹』 c語言代碼編寫的格式

C語言 程序代碼編寫規范
（初級程序員 討論版）
前言
一個好的程序編寫規范是編寫高質量程序的保證。清晰、規范的源程序不僅僅是方便閱讀，更重要的是能夠便於檢查錯誤，提高調試效率，從而最終保證軟體的質量和可維護性。
說明
l 本文檔主要適用於剛剛開始接觸編程的初學者。
l 對於具有一定工程項目開發經驗的程序員，建議學習C語言程序代碼編寫規范—高級版。
目錄
1 代碼書寫規范
2 注釋書寫規范
3 命名規范
4 其它一些小技巧和要求
1 代碼書寫規范
1.1函數定義
花括弧： { }
每個函數的定義和說明應該從第1列開始書寫。函數名（包括參數表）和函數體的花括弧應該各佔一行。在函數體結尾的括弧後面可以加上注釋，注釋中應該包括函數名，這樣比較方便進行括弧配對檢查，也可以清晰地看出來函數是否結束。
範例1：函數的聲明
void matMyFunction(int n)
{
……
} /* matMyFunction*/
1.2空格與空行的使用
要加空格的場合
l 在逗號後面和語句中間的分號後面加空格，如：
int i, j, k;
for (i = 0; i < n; i++)
result = func(a, b, c);
l 在二目運算符的兩邊各留一個空格，如
a > b a <= b i = 0
l 關鍵字兩側，如if () …, 不要寫成if() …
l 類型與指針說明符之間一定要加空格：
char *szName;
不加空格的場合
l 在結構成員引用符號.和->左右兩加不加空格：
pStud->szName, Student.nID
l 不在行尾添加空格或Tab
l 函數名與左括弧之間不加空格:
func(…)
l 指針說明符號*與變數名間不要加空格:
int *pInt; 不要寫成: int * pInt;
l 復合運算符中間不能加空格，否則會產生語法錯誤，如：
a + = b a < = b 都是錯誤的
空行與換行
l 函數的變數說明與執行語句之間加上空行;
l 每個函數內的主要功能塊之間加空行表示區隔;
l 不要在一行中寫多條語句.
範例2：空行與換行
int main()
{
int i, j, nSum = 0; //變數說明

for (i = 0; i < 10; i++) //執行代碼
{
for (j = 0; j < 10; j++)
{
nSum += i;
}
}
}
1.3縮進的設置
根據語句間的層次關系採用縮進格式書寫程序，每進一層，往後縮進一層
有兩種縮進方式：1，使用Tab鍵；2，採用4個空格。
整個文件內部應該統一，不要混用Tab鍵和4個空格，因為不同的編輯器對Tab鍵的處理方法不同。
1.4折行的使用
· 每行的長度不要超過80個字元，當程序行太長時，應該分行書寫。
· 當需要把一個程序行的內容分成幾行寫時，操作符號應該放在行末。
· 分行時應該按照自然的邏輯關系進行，例如：不要把一個簡單的邏輯判斷寫在兩行上。
· 分行後的縮進應該按照程序的邏輯關系進行對齊。例如：參數表折行後，下面的行應該在參數表左括弧的下方。
範例2：折行的格式
dwNewShape = matAffineTransform(coords, translation,
rotation);
if (((new_shape.x > left_border) &&
(new_shape.x < right_border)) &&
((new_shape.y > bottom_border) &&
(new_shape.y < top_border)))
{
draw(new_shape);
}
1.5嵌套語句（語句塊）的格式
對於嵌套式的語句--即語句塊（如，if、while、for、switch等）應該包括在花括弧中。花括弧的左括弧應該單獨佔一行，並與關鍵字對齊。建議即使語句塊中只有一條語句，也應該使用花括弧包括，這樣可以使程序結構更清晰，也可以避免出錯。建議對比較長的塊，在末尾的花括弧後加上注釋以表明該語言塊結束。
範例3：嵌套語句格式
if (value < max)
{
if (value != 0)
{
func(value);
}
}
} else {
error("The value is too big.");
} /* if (value < max) */
2 注釋書寫規范
注釋必須做到清晰，准確地描述內容。對於程序中復雜的部分必須有注釋加以說明。注釋量要適中，過多或過少都易導致閱讀困難。
2.1注釋風格
· C語言中使用一組（/* … */）作為注釋界定符。
· 注釋內容盡量用英語方式表述。
· 注釋的基本樣式參考範例4。
· 注釋應該出現在要說明的內容之前，而不應該出現在其後。
· 除了說明變數的用途和語言塊末尾使用的注釋，盡量不使用行末的注釋方式。
範例4：幾種注釋樣式
/*
* ************************************************
* 強調注釋
* ************************************************
*/
/*
* 塊注釋
*/
/* 單行注釋 */
//單行注釋
int i; /*行末注釋*/
2.2何時需要注釋
· 如果變數的名字不能完全說明其用途，應該使用注釋加以說明。
· 如果為了提高性能而使某些代碼變得難懂，應該使用注釋加以說明。
· 對於一個比較長的程序段落，應該加註釋予以說明。如果設計文檔中有流程圖，則程序中對應的位置應該加註釋予以說明。
· 如果程序中使用了某個復雜的演算法，建議註明其出處。
· 如果在調試中發現某段落容易出現錯誤，應該註明。
3 命名規范
3.1常量、變數命名
l 符號常量的命名用大寫字母表示。如：
#define LENGTH 10
l 如果符號常量由多個單詞構成，兩個不同的單詞之間可以用下劃線連接。如：
#define MAX_LEN 50
變數命名的基本原則：
l 可以選擇有意義的英文（小寫字母）組成變數名，使人看到該變數就能大致清楚其含義。
l 不要使用人名、地名和漢語拼音。
l 如果使用縮寫，應該使用那些約定俗成的，而不是自己編造的。
l 多個單片語成的變數名，除第一個單詞外的其他單詞首字母應該大寫。如：
dwUserInputValue。
3.2函數命名
函數命名原則與變數命名原則基本相同。對於初學者，函數命名可以採用「FunctionName」的形式。
4 其它一些小技巧和要求
l 函數一般情況下應該少於100行
l 函數定義一定要包含返回類型，沒有返回類型加void
l 寫比較表達式時，將常量放在左邊
10 == n
NULL != pInt
l 指針變數總是要初始或重置為NULL
l 使用{}包含復合語句，即使是只有一行，如：
if (1 == a)
{
x = 5;
}
http://home.ustc.e.cn/~danewang/c/CodingStandards.html

『貳』 c語言書寫規則

在C語言編程中，每個說明或語句應獨立占據一行，以確保清晰的視覺結構。

使用大括弧{}來標識程序的不同層次結構，通常這些大括弧會與對應結構的首字母對齊，並單獨佔一行，這樣有助於體現代碼的層次關系。

為了提升代碼的可讀性，低級別的語句或描述應當在高級別語句或定義之後縮進若干格。這種縮進規則有助於區分不同層次，便於理解和維護。

遵循這些書寫規則是養成良好編程習慣的關鍵，它將直接影響到代碼的可讀性和後期的修改效率。因此，在編程過程中，應時刻注意並實踐這些規則。[31]

C語言是一種計算機程序設計語言，它既具有高級語言的特點，又具有匯編語言的特點。它由美國貝爾研究所的D.M.Ritchie於1972年推出，1978年後，C語言已先後被移植到大、中、小及微型機上，它可以作為工作系統設計語言，編寫系統應用程序，也可以作為應用程序設計語言，編寫不依賴計算機硬體的應用程序。它的應用范圍廣泛，具備很強的數據處理能力，不僅僅是在軟體開發上，而且各類科研都需要用到C語言，適於編寫系統軟體，三維，二維圖形和動畫，具體應用比如單片機以及嵌入式系統開發。

『叄』 C程序書寫格式自由,一個語句可以寫在多行上嗎

可以。

1、只要關鍵字不分行就行； 比如： if(a==b || a==c) 等價於 if( a==b || a==c ）。

2、在C語言中，注釋可以加在程序中的任何位置。