代码之家  ›  专栏  ›  技术社区  ›  Ikaso

用ruby编写文档的目的是什么?

  •  4
  • Ikaso  · 技术社区  · 14 年前

    我已经阅读了“Ruby编程语言”一书中的相关文档,但我不明白这些文档的目的是什么,以及什么时候可以在生产代码中使用它们。如果有人能解释并举例说明用法,我会很高兴的。

    当做,

    1 回复  |  直到 14 年前
        1
  •  8
  •   Mark Rushakoff    14 年前

    任何 heredoc 是一种使大字符串变为文字的方便方法。

    采用以下人造的Ruby脚本,该脚本接受您的名字,并为一个告诉您hello的C程序输出源代码:

    #!/usr/bin/env ruby
    name = $*[0]
    
    unless name
      $stderr.puts "Please supply a name as the first argument to the program"
      exit 1
    end
    
    source = <<EOF
    #include <stdio.h>
    
    int main()
    {
        puts("Hello, #{name}!");
        return 0;
    }
    EOF
    
    puts source
    

    除了一个heredoc之外,创建源代码的另一个选项是逐行指定它,这将变得乏味并且可能容易出错(特别是在嵌入引号的情况下)。