edit string & function

ruanyf · ruanyf · commit 7c51ca6cf25d · 2015-10-27T08:30:17.000+08:00
diff --git a/docs/function.md b/docs/function.md
@@ -259,6 +259,8 @@ function f(a, ...b, c) {
 
 ## 扩展运算符
 
+### 含义
+
 扩展运算符（spread）是三个点（...）。它好比rest参数的逆运算，将一个数组转为用逗号分隔的参数序列。
 
 ```javascript
@@ -297,6 +299,8 @@ var args = [0, 1];
 f(-1, ...args, 2, ...[3]);
 ```
 
+### 替代数组的apply方法
+
 由于扩展运算符可以展开数组，所以不再需要`apply`方法，将数组转为函数的参数了。
 
 ```javascript
@@ -342,33 +346,27 @@ arr1.push(...arr2);
 
 上面代码的ES5写法中，`push`方法的参数不能是数组，所以只好通过`apply`方法变通使用`push`方法。有了扩展运算符，就可以直接将数组传入`push`方法。
 
-扩展运算符可以简化很多种ES5的写法。
+下面是另外一个例子。
 
 ```javascript
-// ES5
-[1, 2].concat(more)
-// ES6
-[1, 2, ...more]
-
-// ES5
-list.push.apply(list, [3, 4])
-// ES6
-list.push(...[3, 4])
-
-// ES5
-a = list[0], rest = list.slice(1)
-// ES6
-[a, ...rest] = list
-
 // ES5
 new (Date.bind.apply(Date, [null, 2015, 1, 1]))
 // ES6
 new Date(...[2015, 1, 1]);
 ```
 
-上面的第一个例子，其实提供了数组合并的新写法。
+### 扩展运算符的应用
+
+**（1）合并数组**
+
+扩展运算符提供了数组合并的新写法。
 
 ```javascript
+// ES5
+[1, 2].concat(more)
+// ES6
+[1, 2, ...more]
+
 var arr1 = ['a', 'b'];
 var arr2 = ['c'];
 var arr3 = ['d', 'e'];
@@ -382,7 +380,18 @@ arr1.concat(arr2, arr3));
 // [ 'a', 'b', 'c', 'd', 'e' ]
 ```
 
-扩展运算符也可以与解构赋值结合起来，用于生成数组。
+**（2）与解构赋值结合**
+
+扩展运算符可以与解构赋值结合起来，用于生成数组。
+
+```javascript
+// ES5
+a = list[0], rest = list.slice(1)
+// ES6
+[a, ...rest] = list
+```
+
+下面是另外一些例子。
 
 ```javascript
 const [first, ...rest] = [1, 2, 3, 4, 5];
@@ -408,14 +417,18 @@ const [first, ...middle, last] = [1, 2, 3, 4, 5];
 // 报错
 ```
 
+**（3）函数的返回值**
+
 JavaScript的函数只能返回一个值，如果需要返回多个值，只能返回数组或对象。扩展运算符提供了解决这个问题的一种变通方法。
 
 ```javascript
 var dateFields = readDateFields(database);
 var d = new Date(...dateFields);
 ```
 
-上面代码从数据库取出一行数据，通过扩展运算符，直接将其传入构造函数Date。
+上面代码从数据库取出一行数据，通过扩展运算符，直接将其传入构造函数`Date`。
+
+**（4）字符串**
 
 扩展运算符还可以将字符串转为真正的数组。
 
@@ -424,6 +437,39 @@ var d = new Date(...dateFields);
 // [ "h", "e", "l", "l", "o" ]
 ```
 
+上面的写法，有一个重要的好处，那就是能够正确识别32位的Unicode字符。
+
+```javascript
+'x\uD83D\uDE80y'.length // 4
+[...'x\uD83D\uDE80y'].length // 3
+```
+
+上面代码的第一种写法，JavaScript会将32位Unicode字符，识别为2个字符，采用扩展运算符就没有这个问题。因此，正确返回字符串长度的函数，可以像下面这样写。
+
+```javascript
+function length(str) {
+  return [...str].length;
+}
+
+length('x\uD83D\uDE80y') // 3
+```
+
+凡是涉及到操作32位Unicode字符的函数，都有这个问题。因此，最好都用扩展运算符改写。
+
+```javascript
+let str = 'x\uD83D\uDE80y';
+
+str.split('').reverse().join('')
+// 'y\uDE80\uD83Dx'
+
+[...str].reverse().join('')
+// 'y\uD83D\uDE80x'
+```
+
+上面代码中，如果不用扩展运算符，字符串的`reverse`操作就不正确。
+
+**（5）类似数组的对象**
+
 任何类似数组的对象，都可以用扩展运算符转为真正的数组。
 
 ```javascript
@@ -433,6 +479,8 @@ var array = [...nodeList];
 
 上面代码中，`querySelectorAll`方法返回的是一个`nodeList`对象，扩展运算符可以将其转为真正的数组。
 
+**（6）Map和Set结构，Generator函数**
+
 扩展运算符内部调用的是数据结构的Iterator接口，因此只要具有Iterator接口的对象，都可以使用扩展运算符，比如Map结构。
 
 ```javascript
diff --git a/docs/string.md b/docs/string.md
@@ -65,24 +65,44 @@ s.charCodeAt(0) // 55362
 s.charCodeAt(1) // 57271
 ```
 
-上面代码中，汉字“𠮷”的码点是0x20BB7，UTF-16编码为0xD842 0xDFB7（十进制为55362 57271），需要4个字节储存。对于这种4个字节的字符，JavaScript不能正确处理，字符串长度会误判为2，而且charAt方法无法读取字符，charCodeAt方法只能分别返回前两个字节和后两个字节的值。
+上面代码中，汉字“𠮷”的码点是`0x20BB7`，UTF-16编码为`0xD842 0xDFB7`（十进制为55362 57271），需要4个字节储存。对于这种4个字节的字符，JavaScript不能正确处理，字符串长度会误判为2，而且`charAt`方法无法读取整个字符，`charCodeAt`方法只能分别返回前两个字节和后两个字节的值。
 
-ES6提供了codePointAt方法，能够正确处理4个字节储存的字符，返回一个字符的码点。
+ES6提供了`codePointAt`方法，能够正确处理4个字节储存的字符，返回一个字符的码点。
 
 ```javascript
-var s = "𠮷a";
+var s = '𠮷a';
 
 s.codePointAt(0) // 134071
 s.codePointAt(1) // 57271
 
 s.charCodeAt(2) // 97
 ```
 
-codePointAt方法的参数，是字符在字符串中的位置（从0开始）。上面代码中，JavaScript将“𠮷a”视为三个字符，codePointAt方法在第一个字符上，正确地识别了“𠮷”，返回了它的十进制码点134071（即十六进制的20BB7）。在第二个字符（即“𠮷”的后两个字节）和第三个字符“a”上，codePointAt方法的结果与charCodeAt方法相同。
+`codePointAt`方法的参数，是字符在字符串中的位置（从0开始）。上面代码中，JavaScript将“𠮷a”视为三个字符，codePointAt方法在第一个字符上，正确地识别了“𠮷”，返回了它的十进制码点134071（即十六进制的`20BB7`）。在第二个字符（即“𠮷”的后两个字节）和第三个字符“a”上，`codePointAt`方法的结果与`charCodeAt`方法相同。
 
-总之，codePointAt方法会正确返回四字节的UTF-16字符的码点。对于那些两个字节储存的常规字符，它的返回结果与charCodeAt方法相同。
+总之，`codePointAt`方法会正确返回32位的UTF-16字符的码点。对于那些两个字节储存的常规字符，它的返回结果与`charCodeAt`方法相同。
 
-codePointAt方法是测试一个字符由两个字节还是由四个字节组成的最简单方法。
+`codePointAt`方法返回的是码点的十进制值，如果想要十六进制的值，可以使用`toString`方法转换一下。
+
+```javascript
+var s = '𠮷a';
+
+s.codePointAt(0).toString(16) // "20bb7"
+s.charCodeAt(2).toString(16) // "61"
+```
+
+你可能注意到了，`codePointAt`方法的参数，仍然是不正确的。比如，上面代码中，字符`a`在字符串`s`的正确位置序号应该是1，但是必须向`charCodeAt`方法传入2。解决这个问题的一个办法是使用`for...of`循环，因为它会正确识别32位的UTF-16字符。
+
+```javascript
+var s = '𠮷a';
+for (let ch of s) {
+  console.log(ch.codePointAt(0).toString(16));
+}
+// "20bb7"
+// ""
+```
+
+`codePointAt`方法是测试一个字符由两个字节还是由四个字节组成的最简单方法。
 
 ```javascript
 function is32Bit(c) {
@@ -95,7 +115,7 @@ is32Bit("a") // false
 
 ## String.fromCodePoint()
 
-ES5提供`String.fromCharCode`方法，用于从码点返回对应字符，但是这个方法不能识别辅助平面的字符（编号大于`0xFFFF`）。
+ES5提供`String.fromCharCode`方法，用于从码点返回对应字符，但是这个方法不能识别32位的UTF-16字符（Unicode编号大于`0xFFFF`）。
 
 ```javascript
 String.fromCharCode(0x20BB7)
@@ -109,9 +129,13 @@ ES6提供了`String.fromCodePoint`方法，可以识别`0xFFFF`的字符，弥
 ```javascript
 String.fromCodePoint(0x20BB7)
 // "𠮷"
+String.fromCodePoint(0x78, 0x1f680, 0x79) === 'x\uD83D\uDE80y'
+// true
 ```
 
-注意，`fromCodePoint`方法定义在String对象上，而`codePointAt`方法定义在字符串的实例对象上。
+上面代码中，如果`String.fromCharCode`方法有多个参数，则它们会被合并成一个字符串返回。
+
+注意，`fromCodePoint`方法定义在`String`对象上，而`codePointAt`方法定义在字符串的实例对象上。
 
 ## 字符串的遍历器接口
 
@@ -165,7 +189,7 @@ ES7提供了字符串实例的`at`方法，可以识别Unicode编号大于`0xFFF
 
 ## normalize()
 
-为了表示语调和重音符号，Unicode提供了两种方法。一种是直接提供带重音符号的字符，比如Ǒ（\u01D1）。另一种是提供合成符号（combining character），即原字符与重音符号的合成，两个字符合成一个字符，比如`O`（\u004F）和`ˇ`（\u030C）合成`Ǒ`（\u004F\u030C）。
+为了表示语调和重音符号，Unicode提供了两种方法。一种是直接提供带重音符号的字符，比如`Ǒ`（\u01D1）。另一种是提供合成符号（combining character），即原字符与重音符号的合成，两个字符合成一个字符，比如`O`（\u004F）和`ˇ`（\u030C）合成`Ǒ`（\u004F\u030C）。
 
 这两种表示方法，在视觉和语义上都等价，但是JavaScript不能识别。
 
@@ -178,32 +202,32 @@ ES7提供了字符串实例的`at`方法，可以识别Unicode编号大于`0xFFF
 
 上面代码表示，JavaScript将合成字符视为两个字符，导致两种表示方法不相等。
 
-ES6提供`String.prototype.normalize()`方法，用来将字符的不同表示方法统一为同样的形式，这称为Unicode正规化。
+ES6提供字符串实例的`normalize()`方法，用来将字符的不同表示方法统一为同样的形式，这称为Unicode正规化。
 
 ```javascript
 '\u01D1'.normalize() === '\u004F\u030C'.normalize()
 // true
 ```
 
-normalize方法可以接受四个参数。
+`normalize`方法可以接受四个参数。
 
-- NFC，默认参数，表示“标准等价合成”（Normalization Form Canonical Composition），返回多个简单字符的合成字符。所谓“标准等价”指的是视觉和语义上的等价。
-- NFD，表示“标准等价分解”（Normalization Form Canonical Decomposition），即在标准等价的前提下，返回合成字符分解的多个简单字符。
-- NFKC，表示“兼容等价合成”（Normalization Form Compatibility Composition），返回合成字符。所谓“兼容等价”指的是语义上存在等价，但视觉上不等价，比如“囍”和“喜喜”。
-- NFKD，表示“兼容等价分解”（Normalization Form Compatibility Decomposition），即在兼容等价的前提下，返回合成字符分解的多个简单字符。
+- `NFC`，默认参数，表示“标准等价合成”（Normalization Form Canonical Composition），返回多个简单字符的合成字符。所谓“标准等价”指的是视觉和语义上的等价。
+- `NFD`，表示“标准等价分解”（Normalization Form Canonical Decomposition），即在标准等价的前提下，返回合成字符分解的多个简单字符。
+- `NFKC`，表示“兼容等价合成”（Normalization Form Compatibility Composition），返回合成字符。所谓“兼容等价”指的是语义上存在等价，但视觉上不等价，比如“囍”和“喜喜”。（这只是用来举例，`normalize`方法不能识别中文。）
+- `NFKD`，表示“兼容等价分解”（Normalization Form Compatibility Decomposition），即在兼容等价的前提下，返回合成字符分解的多个简单字符。
 
 ```javascript
 '\u004F\u030C'.normalize('NFC').length // 1
 '\u004F\u030C'.normalize('NFD').length // 2
 ```
 
-上面代码表示，NFC参数返回字符的合成形式，NFD参数返回字符的分解形式。
+上面代码表示，`NFC`参数返回字符的合成形式，`NFD`参数返回字符的分解形式。
 
-不过，normalize方法目前不能识别三个或三个以上字符的合成。这种情况下，还是只能使用正则表达式，通过Unicode编号区间判断。
+不过，`normalize`方法目前不能识别三个或三个以上字符的合成。这种情况下，还是只能使用正则表达式，通过Unicode编号区间判断。
 
 ## includes(), startsWith(), endsWith()
 
-传统上，JavaScript只有indexOf方法，可以用来确定一个字符串是否包含在另一个字符串中。ES6又提供了三种新方法。
+传统上，JavaScript只有`indexOf`方法，可以用来确定一个字符串是否包含在另一个字符串中。ES6又提供了三种新方法。
 
 - **includes()**：返回布尔值，表示是否找到了参数字符串。
 - **startsWith()**：返回布尔值，表示参数字符串是否在源字符串的头部。
@@ -227,11 +251,11 @@ s.endsWith('Hello', 5) // true
 s.includes('Hello', 6) // false
 ```
 
-上面代码表示，使用第二个参数n时，endsWith的行为与其他两个方法有所不同。它针对前n个字符，而其他两个方法针对从第n个位置直到字符串结束。
+上面代码表示，使用第二个参数`n`时，`endsWith`的行为与其他两个方法有所不同。它针对前`n`个字符，而其他两个方法针对从第`n`个位置直到字符串结束。
 
 ## repeat()
 
-`repeat`方法返回一个新字符串，表示将原字符串重复n次。
+`repeat`方法返回一个新字符串，表示将原字符串重复`n`次。
 
 ```javascript
 'x'.repeat(3) // "xxx"
