為什麼這篇備註用法鄉民發文收入到精華區：因為在備註用法這個討論話題中，有許多相關的文章在討論，這篇最有參考價值！作者edash (團長)看板PHP標題[請益] 關於註解的用法時間Tue Sep 17 11:14:...
備註用法 在 Bonnie 邦妮 / Bon Bon Stickers Instagram 的最讚貼文
2021-09-24 02:14:21
#邦妮本本2021 無印立式 0906-0912 又換了用法，上次分享配色是用來寫預計的事項，但我檢視時發現，在時間過去後，我不需要知道哪些是預定，哪些是實際有做完的，有顏色區分反而讓我混淆。 所以這週就不那樣做了，又回去之前的方式，黑色主要，另一色（本週是黃色）寫備註和其他補充。杏色的粗筆是斷食...
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
推 LPH66:comment out code 的意思應該是將程式碼註解(取消)掉 09/17 11:19
→ edash:只是相對來說，comment on該如何解釋較為適宜? 09/17 12:02
※ 編輯: edash 來自: 111.248.88.118 (09/17 12:03)推 LaPass:這種東西寫過一陣子之後就知道該如何註解了..... 09/17 13:47
→ LaPass:結果我看這一段完全看不懂 XD 09/17 13:48
→ danny8376:簡單來說 一般而言說明用的註解 會用C++ style 09/17 14:38
→ danny8376:而C style通常是1F說的註解掉code 09/17 14:39
→ danny8376:不過遇到那種說明函數功能 還是版權訊息之類的 09/17 14:40
→ danny8376:那種很長註解還是會用C style 09/17 14:40
推 visa9527:我看過多行說明的反而是每行前面 // 首尾用一堆 ****** 09/17 14:46
→ danny8376:樓上肯定不常看到標準化的lib www 09/18 01:10
→ edash:謝謝大家回應，我總結一下結論，comment out的意思是使程式 09/18 10:51
→ edash:碼失效，而comment on code的意思是解釋該程式碼的作用 09/18 10:52
推 cwlin0416:comment out 指的是包覆式的註解, 一個區塊, 不是單行 09/22 22:18
→ cwlin0416:comment on 是指在某一行程式碼上註解...意思就單行註解 09/22 22:19
→ cwlin0416:comment out code,out其實講的就是在某段程式的頭尾註解 09/22 22:21
推 cwlin0416:comment on code,是指你在某一段code的某一行註解... 09/22 22:23
→ cwlin0416:anyway, 它只是單純講有這兩種註解方式而已.., 09/22 22:25
→ edash:謝謝回應 09/29 21:40