PTT數位生活區 / PHP

[請益] 關於註解的用法

看板PHP作者 (團長)時間12年前 (2013/09/17 11:14), 編輯推噓5(5推 0噓 13→)
留言18則, 6人參與, 最新討論串1/2 (看更多)
PHP provides several ways to include comments within your code, all of which are borrowed from existing languages such as C, C++, and the Unix shell. In general, use C-style comments to comment out code, and C++-style comments to comment on code. 節錄書本其中一段，主要是第二句的問題，書中將out與on使用斜體表示。根據該書 說法，C-style指的是/*...*/，C++-style指的是// 從字面上看來，個人猜測第二段的意思應該是指C-style註解用在程式之外，也就是 不跟程式碼夾雜在一起。C++-style註解用在程式碼之中，也就是註解特定行的程式碼。 不太確定自己的解讀是否正確，請板友多多指教，謝謝。 -- ※ 發信站: 批踢踢實業坊(ptt.cc) ◆ From: 111.248.88.118
推
09/17 11:19, , 1F
comment out code 的意思應該是將程式碼註解(取消)掉
09/17 11:19, 1F
→
09/17 12:02, , 2F
只是相對來說，comment on該如何解釋較為適宜?
09/17 12:02, 2F
※ 編輯: edash 來自: 111.248.88.118 (09/17 12:03)
推
09/17 13:47, , 3F
這種東西寫過一陣子之後就知道該如何註解了.....
09/17 13:47, 3F
→
09/17 13:48, , 4F
結果我看這一段完全看不懂 XD
09/17 13:48, 4F
→
09/17 14:38, , 5F
簡單來說 一般而言說明用的註解 會用C++ style
09/17 14:38, 5F
→
09/17 14:39, , 6F
而C style通常是1F說的註解掉code
09/17 14:39, 6F
→
09/17 14:40, , 7F
不過遇到那種說明函數功能 還是版權訊息之類的
09/17 14:40, 7F
→
09/17 14:40, , 8F
那種很長註解還是會用C style
09/17 14:40, 8F
推
09/17 14:46, , 9F
我看過多行說明的反而是每行前面 // 首尾用一堆 ******
09/17 14:46, 9F
→
09/18 01:10, , 10F
樓上肯定不常看到標準化的lib www
09/18 01:10, 10F
→
09/18 10:51, , 11F
謝謝大家回應，我總結一下結論，comment out的意思是使程式
09/18 10:51, 11F
→
09/18 10:52, , 12F
碼失效，而comment on code的意思是解釋該程式碼的作用
09/18 10:52, 12F
推
09/22 22:18, , 13F
comment out 指的是包覆式的註解, 一個區塊, 不是單行
09/22 22:18, 13F
→
09/22 22:19, , 14F
comment on 是指在某一行程式碼上註解...意思就單行註解
09/22 22:19, 14F
→
09/22 22:21, , 15F
comment out code,out其實講的就是在某段程式的頭尾註解
09/22 22:21, 15F
推
09/22 22:23, , 16F
comment on code,是指你在某一段code的某一行註解...
09/22 22:23, 16F
→
09/22 22:25, , 17F
anyway, 它只是單純講有這兩種註解方式而已..,
09/22 22:25, 17F
→
09/29 21:40, , 18F
謝謝回應
09/29 21:40, 18F
‣ 更多 edash 的文章
文章代碼(AID): #1IDyap2n (PHP)
討論串 (同標題文章)
以下文章回應了本文：
完整討論串 (本文為第 1 之 2 篇)：
排序： 最新先 | 最舊先 | 留言數
在新視窗開啟完整討論串 (共2篇)
PHP 近期熱門文章
更多 近期熱門文章 >>
PTT數位生活區 即時熱門文章
更多 即時熱門文章 >>
‣ 更多 edash 的文章
文章代碼(AID): #1IDyap2n (PHP)