作者edash (团长)
看板PHP
标题[请益] 关於注解的用法
时间Tue Sep 17 11:14:56 2013
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
1F:推 LPH66:comment out code 的意思应该是将程式码注解(取消)掉 09/17 11:19
2F:→ edash:只是相对来说,comment on该如何解释较为适宜? 09/17 12:02
※ 编辑: edash 来自: 111.248.88.118 (09/17 12:03)
3F:推 LaPass:这种东西写过一阵子之後就知道该如何注解了..... 09/17 13:47
4F:→ LaPass:结果我看这一段完全看不懂 XD 09/17 13:48
5F:→ danny8376:简单来说 一般而言说明用的注解 会用C++ style 09/17 14:38
6F:→ danny8376:而C style通常是1F说的注解掉code 09/17 14:39
7F:→ danny8376:不过遇到那种说明函数功能 还是版权讯息之类的 09/17 14:40
8F:→ danny8376:那种很长注解还是会用C style 09/17 14:40
9F:推 visa9527:我看过多行说明的反而是每行前面 // 首尾用一堆 ****** 09/17 14:46
10F:→ danny8376:楼上肯定不常看到标准化的lib www 09/18 01:10
11F:→ edash:谢谢大家回应,我总结一下结论,comment out的意思是使程式 09/18 10:51
12F:→ edash:码失效,而comment on code的意思是解释该程式码的作用 09/18 10:52
13F:推 cwlin0416:comment out 指的是包覆式的注解, 一个区块, 不是单行 09/22 22:18
14F:→ cwlin0416:comment on 是指在某一行程式码上注解...意思就单行注解 09/22 22:19
15F:→ cwlin0416:comment out code,out其实讲的就是在某段程式的头尾注解 09/22 22:21
16F:推 cwlin0416:comment on code,是指你在某一段code的某一行注解... 09/22 22:23
17F:→ cwlin0416:anyway, 它只是单纯讲有这两种注解方式而已.., 09/22 22:25
18F:→ edash:谢谢回应 09/29 21:40