3.1 注释与分行

Ruby中的注释有单行与多行两种，先看一个程序E3.1-1.rb：

ruby 代码

#   E3.1-1.rb    从#开始到行尾是单行注释
puts  3/5
puts  3/5.0
=begin
  puts  6/5
  puts  6/5.0
  多行注释可以用=begin  和  =end ；
  实际上，这也是Ruby的内嵌文档（Rdoc）注释，类似javadoc  ，
  可以用命令 r i 从源文件生产文档。
=end

运行结果：
>ruby E3.1-1.rb
0
0.6
>Exit code: 0

Rdoc是内嵌在ruby代码之中的，可以转换为html文档说明。类似javadoc。
ri 是一个命令行程序，用来查看函数说明、类说明。函数说明、类说明应该放置在 =begin 和 =end 之中。“=begin”一定要写在行首，也就是说，这一行的前六个字符是“=begin”，不允许有空格在这之前。
Ruby中用分号“ ； ”来表示一个语句的结束。一行如果有多个语句，每个语句用分号隔开，而最后一个语句可以省略分号。换行符表示一行结束。如果语句太长，可以用“ \ ”连接下一行。看程序E3.1-2.rb：

ruby 代码

#   E3.1-2.rb    演示分行
puts  3/5 ; puts  3/5.0
puts  "这里演示" \
"连行"

运行结果：
>ruby E3.1-2.rb
0
0.6
这里演示连行
>Exit code: 0

完整阅读，请看我写的 Ruby语言中文教程all in one    

评论

1 楼 yangzhihuan 2008-02-28  

正想知道ruby是怎么样生成像javadoc那样的文档,多谢了.