diff --git a/zh-cn/cheatsheets/index.md b/zh-cn/cheatsheets/index.md index f823b1277d..156103e494 100644 --- a/zh-cn/cheatsheets/index.md +++ b/zh-cn/cheatsheets/index.md @@ -12,25 +12,25 @@ languages: [zh-cn] | | | | ------ | ------ | | 变量 | | -| `var x = 5` | 变量 | +|  `var x = 5`                                                                                             | 可变量       | | Good `val x = 5`
Bad `x=6` | 常量 | |  `var x: Double = 5`                                                                                     | 显式类型 | | 函数 | | -| Good `def f(x: Int) = { x*x }`
Bad `def f(x: Int) { x*x }` | 定义函数
隐藏错误: 没有“=”程序会返回Unit类型,这将会引起重大灾难。 | +|  Good `def f(x: Int) = { x*x }`
Bad `def f(x: Int)   { x*x }` | 定义函数
隐藏出错: 不加“=”号将会是一段返回Unit类型的过程,这将会导致意想不到的错误。 | | Good `def f(x: Any) = println(x)`
Bad `def f(x) = println(x)` | 定义函数
语法错误: 每个参数都需要指定类型。 | | `type R = Double` | 类型别名 | |  `def f(x: R)` vs.
`def f(x: => R)`                                                                 | 传值调用
传名调用 (惰性参数) | | `(x:R) => x*x` | 匿名函数 | | `(1 to 5).map(_*2)` vs.
`(1 to 5).reduceLeft( _+_ )` | 匿名函数: 下划线是arg参数的占位符。 | | `(1 to 5).map( x => x*x )` | 匿名函数: 必须命名以后才可以使用一个arg参数两次。 | -| Good `(1 to 5).map(2*)`
Bad `(1 to 5).map(*2)` | 匿名函数: 边界前缀方法,理智的人都用`2*_`。 | -|  `(1 to 5).map { x => val y=x*2; println(y); y }`                                                             | 匿名函数: 程序块风格,返回的是最后一个表达式。 | -| `(1 to 5) filter {_%2 == 0} map {_*2}` | 匿名函数: 管道风格(或者叫括号风格)。 | -| `def compose(g:R=>R, h:R=>R) = (x:R) => g(h(x))`
`val f = compose({_*2}, {_-1})` | 匿名函数: 要传入多个程序块的话,需要外部括号。 | -| `val zscore = (mean:R, sd:R) => (x:R) => (x-mean)/sd` | 柯里化, 很显然的语法。 | -| `def zscore(mean:R, sd:R) = (x:R) => (x-mean)/sd` | 柯里化, 很显然的语法。 | -| `def zscore(mean:R, sd:R)(x:R) = (x-mean)/sd` | 柯里化,语法糖。 | -|  `val normer = zscore(7, 0.4) _`                                                                         | 需要在后面加下划线来部分应用(只适用于语法糖版本)。 | +|  Good `(1 to 5).map(2*)`
Bad `(1 to 5).map(*2)` | 匿名函数: 绑定前缀方法,理智的方法是`2*_`。 | +|  `(1 to 5).map { x => val y=x*2; println(y); y }`                                                             | 匿名函数: 程序块风格,最后一个表达式作为返回值。 | +|  `(1 to 5) filter {_%2 == 0} map {_*2}`                                                                 | 匿名函数: 管道风格(或者用圆括号)。 | +|  `def compose(g:R=>R, h:R=>R) = (x:R) => g(h(x))`
`val f = compose({_*2}, {_-1})`                   | 匿名函数: 要传入多个程序块的话,需要外围括号。 | +| `val zscore = (mean:R, sd:R) => (x:R) => (x-mean)/sd` | 柯里化, 显然的语法。 | +| `def zscore(mean:R, sd:R) = (x:R) => (x-mean)/sd` | 柯里化, 显然的语法。 | +|  `def zscore(mean:R, sd:R)(x:R) = (x-mean)/sd`                                                           | 柯里化,语法糖。然后:) | +|  `val normer = zscore(7, 0.4) _`                                                                         | 需要在尾部加下划线来变成偏函数(只对语法糖版本适用)。 | | `def mapmake[T](g:T=>T)(seq: List[T]) = seq.map(g)` | 泛型 | |  `5.+(3); 5 + 3`
`(1 to 5) map (_*2)`                                                               | 中缀语法糖 | | `def sum(args: Int*) = args.reduceLeft(_+_)` | 可变参数 | @@ -39,28 +39,28 @@ languages: [zh-cn] | `import scala.collection.Vector`
`import scala.collection.{Vector, Sequence}` | 选择性导入 | | `import scala.collection.{Vector => Vec28}` | 重命名导入 | | `import java.util.{Date => _, _}` | 导入java.util包里除Date之外的所有文件. | -| `package pkg` _at start of file_
`package pkg { ... }` | 声明一个包 | +|  `package pkg` _at start of file_
`package pkg { ... }`                                             | 声明这是一个包 | | 数据结构 | | |  `(1,2,3)`                                                                                               | 元组字面量 (`Tuple3`) | | `var (x,y,z) = (1,2,3)` | 解构绑定:通过模式匹配来解构元组。 | -| Bad`var x,y,z = (1,2,3)` | 隐藏错误:每一个变量都被赋值了整个元组。 | +|  Bad`var x,y,z = (1,2,3)`                                           | 隐藏出错:每一个变量都被赋值了整个元组。 | | `var xs = List(1,2,3)` | 列表 (不可变). | | `xs(2)` | 用括号索引 ([slides](http://www.slideshare.net/Odersky/fosdem-2009-1013261/27)) | -|  `1 :: List(2,3)`                                                                                       | cons | +|  `1 :: List(2,3)`                                                                                       | Cons(构成) | |  `1 to 5` _等价于_ `1 until 6`
`1 to 10 by 2`                                                     | Range类型(语法糖) | -|  `()` _(空括号)_                                                                                   | Unit类型的专有成员 (相当于 C/Java 里的void). | +|  `()` _(空括号)_                                                                                   | Unit类型的唯一成员 (相当于 C/Java 里的void). | | 控制结构 | | | `if (check) happy else sad` | 条件 | | `if (check) happy` _same as_
`if (check) happy else ()` | 条件(语法糖) | | `while (x < 5) { println(x); x += 1}` | while循环 | | `do { println(x); x += 1} while (x < 5)` | do while循环 | | `import scala.util.control.Breaks._`
`breakable {`
` for (x <- xs) {`
` if (Math.random < 0.1) break`
` }`
`}`| break. ([slides](http://www.slideshare.net/Odersky/fosdem-2009-1013261/21)) | -|  `for (x <- xs if x%2 == 0) yield x*10` _等价于_
`xs.filter(_%2 == 0).map(_*10)`                   | for循环: filter/map | -|  `for ((x,y) <- xs zip ys) yield x*y` _等价于_
`(xs zip ys) map { case (x,y) => x*y }`             | for循环: 解构绑定 | -| `for (x <- xs; y <- ys) yield x*y` _等价于_
`xs flatMap {x => ys map {y => x*y}}` | for循环: 叉乘 | -|  `for (x <- xs; y <- ys) {`
   `println("%d/%d = %.1f".format(x, y, x/y.toFloat))`
`}`                     | for循环: 不可避免的格式
[sprintf-style](http://java.sun.com/javase/6/docs/api/java/util/Formatter.html#syntax) | -| `for (i <- 1 to 5) {`
`println(i)`
`}` | for循环: 包括上边界的遍历 | -| `for (i <- 1 until 5) {`
`println(i)`
`}` | for循环: 忽略上边界的遍历 | +|  `for (x <- xs if x%2 == 0) yield x*10` _等价于_
`xs.filter(_%2 == 0).map(_*10)`                   | for comprehension (for 导出): filter/map | +|  `for ((x,y) <- xs zip ys) yield x*y` _等价于_
`(xs zip ys) map { case (x,y) => x*y }`             | for comprehension (for 导出): 解构绑定 | +| `for (x <- xs; y <- ys) yield x*y` _等价于_
`xs flatMap {x => ys map {y => x*y}}` | for comprehension (for 导出): 叉乘 | +|  `for (x <- xs; y <- ys) {`
   `println("%d/%d = %.1f".format(x, y, x/y.toFloat))`
`}`                     | for comprehension (for 导出): 不可避免的格式
[sprintf-style](http://java.sun.com/javase/6/docs/api/java/util/Formatter.html#syntax) | +| `for (i <- 1 to 5) {`
`println(i)`
`}` | for comprehension (for 导出): 包括上边界的遍历 | +| `for (i <- 1 until 5) {`
`println(i)`
`}` | for comprehension (for 导出): 忽略上边界的遍历 | | 模式匹配 | | |  Good `(xs zip ys) map { case (x,y) => x*y }`
Bad `(xs zip ys) map( (x,y) => x*y )` | 在函数的参数中使用模式匹配的例子。 | | Bad
`val v42 = 42`
`Some(3) match {`
` case Some(v42) => println("42")`
` case _ => println("Not 42")`
`}` | "v42" 被解释为可以匹配任何Int类型值的名称,打印输出"42"。 | @@ -74,10 +74,10 @@ languages: [zh-cn] | `abstract class D { ... }` | 定义一个抽象类。(不可创建) | | `class C extends D { ... }` | 定义一个继承子类。 | | `class D(var x: R)`
`class C(x: R) extends D(x)` | 继承与构造器参数(愿望清单: 默认自动传参) -| `object O extends D { ... }` | 定义一个单例模式(模块化的) | +|  `object O extends D { ... }`                                                                           | 定义一个单例(和模块一样) | |  `trait T { ... }`
`class C extends T { ... }`
`class C extends D with T { ... }`                 | 特质
带有实现的接口,没有构造参数。 [mixin-able]({{ site.baseurl }}/tutorials/tour/mixin-class-composition.html). |  `trait T1; trait T2`
`class C extends T1 with T2`
`class C extends D with T1 with T2`             | (混入)多个特质 | -|  `class C extends D { override def f = ...}`                                                           | 必须声明函数的重写。 | +|  `class C extends D { override def f = ...}`                                                           | 必须声明覆盖该方法。 | |  `new java.io.File("f")`                                                                             | 创建对象。 | |  Bad `new List[Int]`
Good `List(1,2,3)` | 类型错误: 抽象类型
相反,习惯上:调用工厂(方法)会自动推测类型 | | `classOf[String]` | 类字面量 |