From df395dadd0f5ba522869a83a229490121306f7e0 Mon Sep 17 00:00:00 2001
From: leo <lisong1205@126.com>
Date: Sat, 26 Mar 2016 22:42:15 +0800
Subject: [PATCH 1/2] add chapter 17 and section 17.1

---
 eBook/17.0.md      |  7 +++++
 eBook/17.1.md      | 76 ++++++++++++++++++++++++++++++++++++++++++++++
 eBook/directory.md |  3 +-
 3 files changed, 85 insertions(+), 1 deletion(-)
 create mode 100644 eBook/17.0.md
 create mode 100644 eBook/17.1.md

diff --git a/eBook/17.0.md b/eBook/17.0.md
new file mode 100644
index 0000000..051f764
--- /dev/null
+++ b/eBook/17.0.md
@@ -0,0 +1,7 @@
+# 17 模式
+
+## 链接
+
+- [目录](directory.md)
+- 上一章：[糟糕的错误处理](16.10.md)
+- 下一节：[关于逗号ok模式](17.1.md)
\ No newline at end of file
diff --git a/eBook/17.1.md b/eBook/17.1.md
new file mode 100644
index 0000000..81aa5b3
--- /dev/null
+++ b/eBook/17.1.md
@@ -0,0 +1,76 @@
+# 17.1 关于逗号ok模式
+
+在学习本书第二部分和第三部分时，我们经常在一个表达式返回2个参数时使用这种模式：`，ok`，第一个参数是一个值或者`nil`，第二个参数是`true`/`false`或者一个错误`error`。在一个需要赋值的`if`条件语句中，使用这种模式去检测第二个参数值会让代码显得优雅简洁。这种模式在go语言编码规范中非常重要。下面总结了所有使用这种模式的例子：
+
+（1）在函数返回时检测错误（参考[第5.2小节](05.2.md)）:
+
+```go
+if value, err := pack1.Func1(param1); err != nil {
+    fmt.Printf(“Error %s in pack1.Func1 with parameter %v”, err.Error(), param1)
+    return err
+}
+// 函数Func1没有错误:
+Process(value)
+
+e.g.: os.Open(file) strconv.Atoi(str)
+```
+
+这段代码中的函数将错误返回给它的调用者，当函数执行成功时，返回的错误是`nil`，所以使用这种写法：
+
+```go
+func SomeFunc() error {
+    …
+    if value, err := pack1.Func1(param1); err != nil {
+        …
+        return err
+    }
+    …
+    return nil
+}
+```
+
+这种模式也常用于通过`defer`使程序从`panic`中恢复执行（参考[第17.2（4）小节](17.2.md)）。
+
+要实现简洁的错误检测代码，更好的方式是使用闭包，参考[第16.10.2小节](16.10.md)
+
+（2）检测映射中是否存在一个键值（参考[第8.2小节](08.2.md)）：`key1`在映射`map1`中是否有值？
+
+```go
+if value, isPresent = map1[key1]; isPresent {
+        Process(value)
+}
+// key1不存在
+…
+```
+
+（3）检测一个接口类型变量`varI`是否包含了类型`T`：类型断言（参考[第11.3小节](11.3.md)）：
+
+```go
+if value, ok := varI.(T); ok {
+    Process(value)
+}
+// 接口类型varI没有包含类型T
+```
+
+（4）检测一个通道`ch`是否关闭（参考[第14.3小节](14.3.md)）：
+
+```go
+    for input := range ch {
+        Process(input)
+    }
+
+或者:
+
+    for {
+        if input, open := <-ch; !open {
+            break // 通道是关闭的
+        }
+        Process(input)
+    }
+```
+
+## 链接
+
+- [目录](directory.md)
+- 上一节：[关于逗号ok模式](17.0.md)
+- 下一节：[关于defer模式](17.2.md)
\ No newline at end of file
diff --git a/eBook/directory.md b/eBook/directory.md
index 0936074..72df235 100644
--- a/eBook/directory.md
+++ b/eBook/directory.md
@@ -161,7 +161,8 @@
     - 16.8 [误用协程和通道](16.8.md)
     - 16.9 [闭包和协程的使用](16.9.md)
     - 16.10 [糟糕的错误处理](16.10.md)
-- 第17章：模式
+- 第17章：[模式](17.0.md)
+    - 17.1 [关于逗号ok模式](17.1.md)
 - 第18章：[出于性能考虑的实用代码片段](18.0.md)
     - 18.1 [字符串](18.1.md)
     - 18.2 [数组和切片](18.2.md)

From c728b453e30188535ee846ed9a29622062a4c75a Mon Sep 17 00:00:00 2001
From: leo <lisong1205@126.com>
Date: Sat, 26 Mar 2016 22:46:49 +0800
Subject: [PATCH 2/2] update

---
 eBook/17.1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/eBook/17.1.md b/eBook/17.1.md
index 81aa5b3..5d6e8eb 100644
--- a/eBook/17.1.md
+++ b/eBook/17.1.md
@@ -72,5 +72,5 @@ if value, ok := varI.(T); ok {
 ## 链接
 
 - [目录](directory.md)
-- 上一节：[关于逗号ok模式](17.0.md)
+- 上一节：[模式](17.0.md)
 - 下一节：[关于defer模式](17.2.md)
\ No newline at end of file