A.2 Ruby程序的注释

上一篇 / 下一篇  2008-06-10 14:09:39

查看( 114 ) / 评论( 16 )
Ruby程序的注释有两种形式：

１、单行注释
２、多行注释

单行注释也是Ruby代码的文档注释，因为你可以用rdoc命令行工具生成Ruby类的rdoc文档。

CODE:

rdoc a.rb运行后在当前目录有一个doc文件夹，打开这个文件夹，打开index.html文件，你就会看见
rdoc生成的文档注释。

多行注释由： 包括在　=begin 和 =end　之间的内容组成，你唯一需要注意的是： =begin 和　=end
必须顶格写。放在　=begin 和　=end 之间的内容会被Ruby忽略。

论坛模式 推荐 收藏 分享给好友 推荐到圈子 管理

TAG:

小飞猪之Ruby窝 drive2me 发布于2008-06-10 23:30:26
我做了实验，同时有单行注释和多行注释，确实是：单行注释也是Ruby代码的文档注释，可以在网页上看到。
但多行注释也确实被Ruby忽略了，就是在网页上没有和单行注释一起显示出来。
我以前没有注意到这些细节。

今天弄到这些细节，干脆都弄明白吧。直接问讲师吧。

问题一：有时需要将多行注释的内容像单行注释一样输出的话，怎么做呢（除了用单行连续注释以外）？

问题二：单行注释被显示在.html网页中，如果需要输出到某个指定的文件，可以吗？能给个例子吗？
quzhongwei的个人空间 quzhongwei 发布于2008-06-10 23:57:19
回复 2# 的帖子
可以考虑：Here Document语法，比如：

puts <<OK
    1、第一行
  2、第二行
OK

＃Here Document语法：
＃<<标识符
＃标识符
＃
＃Here Document的使用很讲究技巧，比如： """ ok """ 等的使用。
＃不知这可以解决你的问题吗？

[ 本帖最后由 quzhongwei 于 2008-6-11 00:03 编辑 ]
小飞猪之Ruby窝 drive2me 发布于2008-06-11 00:18:10
这样吧，你告诉我在哪本相关的书中有介绍，我去查来看看。
可以吗？

为啥提出这些问题？我在考虑如何提高写详细设计文档的效率。
面向对象的详细设计有时可以和编程同时进行的，如果注释能帮助工程师高效完成一些设计的内容，就好了。
比如，Java的注释和Doc功能，如果会利用，就可以帮助工程师高效完成大部分设计的内容。文档是软件工程很重要的部分呀。
quzhongwei的个人空间 quzhongwei 发布于2008-06-11 00:30:05
回复 4# 的帖子
看看这个能否满足伱的要求吗？

《The Ruby Way》

到后面的叙述，我会提到这个问题！

[ 本帖最后由 quzhongwei 于 2008-6-11 00:32 编辑 ]
小飞猪之Ruby窝 drive2me 发布于2008-06-11 01:08:44
OK，我抽时间去看看。谢谢！
枫灯发布于2008-06-11 19:15:41
Here Document语法，标识符需要大写，楼主没讲到。。。
班门弄斧，小弟就知道这个。
小飞猪之Ruby窝 drive2me 发布于2008-06-11 19:19:59

QUOTE:

原帖由 枫灯 于 2008-6-11 19:15 发表
Here Document语法，标识符需要大写，楼主没讲到。。。
班门弄斧，小弟就知道这个。
讲师说了以后会讲到，他只是在回答我的问题，建议我用Here Document来解决我的问题。
我会抽空去看的。

谢谢大家。
quzhongwei的个人空间 quzhongwei 发布于2008-06-11 19:20:41

QUOTE:

原帖由 枫灯 于 2008-6-11 19:15 发表
Here Document语法，标识符需要大写，楼主没讲到。。。
班门弄斧，小弟就知道这个。
还没有正式讲到这个语法点
gongmeihao发布于2008-06-13 17:27:42
我要一步一步往上爬.......
小飞猪之Ruby窝 drive2me 发布于2008-06-13 17:57:21

QUOTE:

原帖由 gongmeihao 于 2008-6-13 17:27 发表
我要一步一步往上爬.......
像小蜗牛了，一步一步地爬，但不怕，有目标呢。
wbflike发布于2008-06-16 10:58:22
看了
dhb008发布于2008-07-14 16:17:32
额。。。。注释具体来说在这里怎么体现出来他的作用呢？？？？我不明白～～
小飞猪之Ruby窝 drive2me 发布于2008-07-14 19:20:54

QUOTE:

原帖由 dhb008 于 2008-7-14 16:17 发表
额。。。。注释具体来说在这里怎么体现出来他的作用呢？？？？我不明白～～
再看看书，就明白了。
alanyuqiang发布于2008-07-26 02:32:35
Here Document标志谁说第一字母要大写的啊？小写也一样可以
karon_flame发布于2008-11-04 11:02:59

QUOTE:

原帖由 drive2me 于 2008-6-10 23:30 发表
我做了实验，同时有单行注释和多行注释，确实是：单行注释也是Ruby代码的文档注释，可以在网页上看到。
但多行注释也确实被Ruby忽略了，就是在网页上没有和单行注释一起显示出来。
我以前没有注意到这些细节。

...
第一个问题,可以这样写

CODE:

#!/usr/bin/ruby
  2 =begin rdoc
  3 puts "hello,Ruby"
  4 def foo
  5  puts "hello,world"
  6 end
  7 =end
  8 class A
  9   puts "A"
10   def WoW
11     puts "WoW"
12   end
13 end然后用rdoc就可以了.
ps：多次单行注释也没有什么不好的,使用vim的话相当方便  1,100 s/^/#/g  这个vim命令是1到100行前面加#注释.

第二个问题

如果你想把程序中的注释统统提取出来放到一个文件里,shell很容易做到哦

cat OOXX.rb | grep '^#' | grep -v '^$' >> OOXX.txt

第一个grep是取出所有#开头的行,第二个grep是排除所有的空格.
alexinuk发布于2008-11-06 17:37:19
正在爬行中。。。。
我来说两句

(可选)

日历

« 2009-01-08  
日 一 二 三 四 五 六
    123
45678910
11121314151617
18192021222324
25262728293031

我的存档

数据统计

  • 访问量: 44
  • 日志数: 19
  • 建立时间: 2008-06-11
  • 更新时间: 2008-06-11

RSS订阅

Open Toolbar