如何在不可变/反应文档页面阅读代码示例答案

【问题标题】：How To Read The Code Sample At Immutable / React Document Pages如何在不可变/反应文档页面阅读代码示例
【发布时间】：2016-03-21 13:31:02
【问题描述】：

其实我迷茫了几天终于决定问这个问题了。

Facebook 团队在 React 和 Immutable pages 上使用这种代码风格。有人可以解释一下如何阅读这些内容。

这是链接页面的代码副本：

List.of<T>(...values: T[]): List<T>

我们应该如何阅读这篇文章？

【问题讨论】：

对什么感到困惑？类型注释？在此示例中，List.of 采用可变数量的 T 类型的参数并返回 List<T> 类型的列表对象。查看 Flow 或 Typescript 文档。
@FelixKling 只是一般，如何阅读该代码。什么是，T[ ]:List。正如我所说，整行对我来说没有意义。
这些都是类型注解。也许这是一个更好的例子：facebook.github.io/immutable-js/docs/#/Collection/count。在文档中有类型注释会告诉您函数期望或返回的值的类型（例如数字）。对于您的示例，您想查看“泛型”。在类型化语言中比较常见：github.com/Microsoft/TypeScript-Handbook/blob/master/pages/….

【解决方案1】：

这-

List.of<T>(...values: T[]): List<T>

意思是-

函数 List.of（取一个或多个 that type) : 并返回 List.

他们文档中的另一个例子 -

update(index: number, notSetValue: T, updater: (value: T) => T): List<T>

意思是-

函数 update(接受 index，它是一个数字，notSetValue 是任何类型，updater 是一个函数(它接受该类型的值) => 并返回该类型)并返回该列表输入。

【讨论】：

感谢 HazardouS 的详细说明。
我发现 TypeScript 手册是“解读”不可变文档的一个很好的配套指南（因为我最近也遇到了类似的问题）。原来这都是标准的 TypeScript 语法 - typescriptlang.org/docs/handbook/generics.html
很好的比较。 Pascal 也推广了相同的语法。