2011-11-16 74 views
0

我正在給C++程序添加註釋。 比方說,我們有這樣的事情:在C++中註釋

string House:: getName(int &size){ 

return name; 
} 

在Java中,當你寫旁邊的星號上述評論你的名字他們是這樣的:

/* 
* @param size It passes the number of rooms. 
    @return name. It returns name of the house 
*/ 

什麼是在C這樣的格式++?

+3

您是否在尋找類似於javadoc的文檔生成工具? – zdan

+0

我認爲有一個關於如何做文檔C++代碼的約定。這就像我給你一個Java代碼的例子。 – ucas

+0

另一種選擇是使用'number_of_rooms'作爲參數名稱而不是'size'。讓你解釋它是什麼。 –

回答

1

如果您使用Visual Studio,here是註釋文檔的規範。

6

您指的是Javadoc,您可以在C++中使用相同風格的註釋和相同的編輯器和外部工具。

評論文檔沒有C++「標準」。

+2

+1,即doxygen。 –

+0

好吧,工具+0.5,說明評論不僅僅關於嵌入元數據和自由評論應該保持自由的形式; +)。 –

2

沒有具體的規定。評論是評論,他們被忽略和扔掉,所以你可以以任何你喜歡的方式塑造他們。

如果您想要使用解釋註釋的程序,例如doxygen,那麼您必須查看該程序的參考。

3

如果您從代碼中提取文檔,那麼您需要遵循適當的評論格式。例如,我們使用DOxygen,所以我們必須遵循Doxygen規則。

如果您不打算爲文檔提取註釋,則適用簡單的良好編碼實踐。