有 Ruby 语法的权威参考文档吗? [关闭]

2024-01-02

我正在寻找有关 Ruby 语法的权威文档。我知道核心 API 和标准库的权威文档,但是语法本身呢?例如,这样的文档应该涵盖:保留字、字符串文字语法、变量/类/模块的命名规则、所有条件语句及其排列等等。

我知道有很多书籍和教程,是的,但每一本本质上都是教程,每一本都有不同的深度和重点。为了简洁和叙事流畅,它们都会省略作者认为无关紧要的某些语言细节。

例如,您是否知道可以使用没有初始 case 值的 case 语句,然后它将执行第一个 true when 子句?任何给定的 Ruby 书籍或教程可能会也可能不会涵盖 case 语法的特定鲜为人知的功能。 “Ruby 编程”中关于 case 语句的部分没有讨论它。但这只是一个小例子。

到目前为止,我发现的最好的文档是 ruby​​spec 项目,它似乎是为该语言编写完整的测试套件的尝试。这还不错,但是从实际的角度来看,作为一个从事我自己项目的开发人员,它有点难以使用。

我只是错过了什么还是真的没有确定的定义整个 Ruby 语法的可读文档?


The only可以合理地描述为“权威”的文档是源代码parse.y https://GitHub.Com/Ruby/Ruby/blob/trunk/parse.y在 YARV 源代码树中。

The ISO 规范草案 http://Ruby-Std.NetLab.Jp/包含 39 页的附录,其中包含语法摘要。但请注意,ISO Ruby 是 Ruby 1.8 和 1.9 交集的最小子集。 IOW:它没有描述仅在 1.8 或仅在 1.9 中的任何内容(因此,没有描述 1.9 中的语法添加,如稳定过程和符号哈希),也没有描述一切在那个路口。在这方面,ISO Ruby 有点像 ISO HTML。

The RubySpec http://RubySpec.Org/项目包含 Ruby 语言的可执行规范。但它不包含语法的明确规范。语法的唯一规范是implicit在例子本身。另外,由于 RubySpec 是一个基于示例的规范,它只能向您展示有效 Ruby 代码的具体示例,但它不能告诉您all可能有效的 Ruby 程序,例如语法规范。而且,由于 RubySpec 本身是可执行的 Ruby 代码,因此它只能向您显示有效的示例,而不是无效的示例。

最后可以被认为是确定的就是这本书Ruby 编程语言 http://OReilly.Com/catalog/9780596516178/作者:David Flanagan 和 Yukihiro "matz" Matsumoto。

但请注意,“整个 Ruby 语法”是一项相当艰巨的任务,因为 Ruby 的语法是insanely因大量奇怪的极端情况而变得复杂。

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

有 Ruby 语法的权威参考文档吗? [关闭] 的相关文章

随机推荐