6 - 函数

README.md

@@ -1,49 +1,67 @@
-####  :orange_book:  持续更新中...
+##  :orange_book:  持续更新中...
 
-###  介绍和安装  
+##  第1章 介绍和安装  
+
+简介：Golang教程系列的第一篇教程。讲述什么是Golang？为什么选择Golang？以及Golang的安装和简单的使用。  
 
 ####  [1 - 介绍和安装](/docs/golang_tutorial_01.md)  
 ####  [2 - Hello World ](/docs/golang_tutorial_02.md)  
 
-### 变量、类型和常量  
+## 第2章 变量、类型和常量  
+
+简介：Golang教程系列的第二篇教程。  讲述Golang 变量、类型以及常量的使用。  
 
 #### [3 - 变量](/docs/golang_tutorial_03.md)  
 #### [4 - 类型](/docs/golang_tutorial_04.md)  
 #### [5 - 常量](/docs/golang_tutorial_05.md)  
 
-###  函数和包  
+##  第3章 函数和包  
+
+简介：Golang教程系列的第三篇教程。讲述Golang 函数和包使用。  
 
 ####  [6 - 函数](/docs/golang_tutorial_06.md)    
 ####  [7 - 包](/docs/golang_tutorial_07.md)  
 
-###  条件和循环语句  
+##  第4章 条件和循环语句  
+
+简介：总览课程，介绍课程学习须知，环境准备，了解课程意义。  
 
 ####  [8 - if else 语句](/docs/golang_tutorial_08.md)  
 ####  [9 - 循环语句](/docs/golang_tutorial_09.md)  
 ####  [10 - switch语句](/docs/golang_tutorial_10.md)  
 
-###  数组、切片和变参函数  
+##  第5章 数组、切片和变参函数  
+
+简介：总览课程，介绍课程学习须知，环境准备，了解课程意义。  
 
 ####  11 - 数组和切片  
 ####  12 - 变参函数  
 
-###  更多的类型
+##  第6章 更多的类型  
+
+简介：总览课程，介绍课程学习须知，环境准备，了解课程意义。  
 
 ####  13 - Map  
 ####  14 - 字符串  
 
-###  指针、结构体和方法
+##  第7章 指针、结构体和方法  
+
+简介：总览课程，介绍课程学习须知，环境准备，了解课程意义。  
 
 ####  15 - 指针  
 ####  16 -  结构体  
 ####  17 - 方法  
 
-###  接口
+##  第8章 接口  
+
+简介：总览课程，介绍课程学习须知，环境准备，了解课程意义。  
 
 ####  18 - 接口一  
 ####  19 - 接口二  
 
-###  并发
+##  第9章 并发  
+
+简介：总览课程，介绍课程学习须知，环境准备，了解课程意义。  
 
 ####  20 - 并发介绍  
 ####  21 - 协程  
@@ -52,13 +70,17 @@
 ####  24 - Select   
 ####  25 - Mutex  
 
-###  面向对象编程
+##  第10章 面向对象编程  
+
+简介：总览课程，介绍课程学习须知，环境准备，了解课程意义。  
 
 ####  26 - 结构体和类  
 ####  27 - 构成和继承  
 ####  28 - 多态性   
 
-###  延迟和错误处理
+##  第11章 延迟和错误处理  
+
+简介：总览课程，介绍课程学习须知，环境准备，了解课程意义。  
 
 ####  29 - 延迟  
 ####  30 - 错误处理  

docs/golang_tutorial_06.md

@@ -0,0 +1,156 @@
+6 - 函数
+========================
+
+这是本Golang系列教程的第6篇。  
+
+## 什么是函数？  
+
+函数是执行特定任务的代码块。 函数接受输入，对输入执行一些计算并生成输出。
+
+## 函数声明  
+
+在 Go 中声明一个函数的语法为：  
+
+```golang
+func functionname(parametername type) returntype {  
+ //function body
+}
+```
+
+函数声明以关键字 `func` 开头，后面是`函数名字`，接着是在 ( 和 ) 之间指定的参数列表，然后是函数的`返回类型`。指定参数的语法为参数名称后面跟着参数类型。可以指定任意数量的参数，形式为： `(parameter1 type, parameter2 type)`。最后是由 `{` 和 `}` 以及它们之间的代码块组成的函数体。  
+
+在一个函数中，参数和返回值是可选的。因此下面的语法也是合法的函数声明：  
+
+```golang
+func functionname() {  
+}
+```
+
+## 函数的例子  
+
+让我们写一个函数，它以单个产品的价格和产品数量作为输入参数，并以总价格（单个产品的价格与产品数量的乘积）作为返回值。  
+
+```golang
+func calculateBill(price int, no int) int {  
+    var totalPrice = price * no
+    return totalPrice
+}
+```
+
+上面的函数接受两个 int 类型的输入参数：`price` 和 `no`，并返回 `totalPrice`（`price` 与` no `的乘积）。返回值的类型也是` int`。  
+
+**如果连续的参数具有相同的类型，我们可以避免每次都写出它们的类型，只需要在结束的时候写一次就可以了**，比如：`price int, no int `可以写成：`price, no int`。 于是上面的函数可以写成：  
+
+```golang
+func calculateBill(price, no int) int {  
+    var totalPrice = price * no
+    return totalPrice
+}
+```
+
+现在我们已经准备好了一个函数，我们可以从代码中的某个地方调用它。 调用函数的语法是`functionname（parameters）`。 上面的函数可以用代码调用。  
+
+```golang
+calculateBill(10, 5)  
+```
+
+下面是完整的程序，它调用 calculateBill 并计算总价格。  
+
+```golang
+package main
+
+import (  
+    "fmt"
+)
+
+func calculateBill(price, no int) int {  
+    var totalPrice = price * no
+    return totalPrice
+}
+func main() {  
+    price, no := 90, 6
+    totalPrice := calculateBill(price, no)
+    fmt.Println("Total price is", totalPrice)
+}
+```
+
+上述程序将打印结果：
+
+```golang
+Total price is 540  
+```
+
+## 多个返回值  
+
+一个函数可以返回多个值。让我们写一个函数 `rectProps`，它接受一个矩形的长和宽，并返回该矩形的面积和周长。矩形的面积为长与宽的积。周长为长与宽的和的 2 倍。  
+
+```golang
+package main
+
+import (  
+    "fmt"
+)
+
+func rectProps(length, width float64)(float64, float64) {  
+    var area = length * width
+    var perimeter = (length + width) * 2
+    return area, perimeter
+}
+
+func main() {  
+     area, perimeter := rectProps(10.8, 5.6)
+    fmt.Printf("Area %f Perimeter %f", area, perimeter) 
+}
+```
+
+如果一个函数有多个返回值，那么这些返回值应该用小括号()括起来，比如：`func rectProps(length, width float64)(float64, float64) `接受两个类型为 `float64` 的参数（`length` 和 `width`），并且同样返回两个类型为 `float64` 的返回值。上面程序的输出为：  
+
+```golang
+Area 60.480000 Perimeter 32.800000  
+```
+
+## 命名返回值  
+
+可以给一个函数的返回值指定名字。如果指定了一个返回值的名字，则可以视为在该函数的第一行中定义了该名字的变量。  
+
+上面的 `rectProps` 函数可以用具名返回值的形式重写如下：  
+
+```golang
+func rectProps(length, width float64)(area, perimeter float64) {  
+    area = length * width
+    perimeter = (length + width) * 2
+    return //no explicit return value
+}
+```
+
+在上面的函数中，`area `和 `perimeter` 是具名返回值。注意 `return` 语句没有指定任何返回值。因为在函数声明时已经指定 `area` 和 `perimeter` 是返回值，在遇到 `return` 语句时它们会自动从函数中返回。  
+
+<u>（译者注：在Go中，有返回值的函数，无论是具名返回值还是普通形式的返回值，函数中必须包含 `return` 语句。）</u>  
+
+## 空指示符  
+
+下划线`_`表示空指示符`blank identifier`。它可以用于代替任何类型的任何值。让我们看看如何使用空指示符。
+
+我们知道上面定义的函数 `rectProps` 返回矩形的面积`area`和周长`perimeter`。如果我们只需要获取 `area` 而想要忽略 `perimeter`该怎么办呢？这时候就可以使用空指示符。  
+
+下面的程序仅接收 `rectProps` 返回的 `area`：  
+
+```golang
+package main
+
+import (  
+    "fmt"
+)
+
+func rectProps(length, width float64) (float64, float64) {  
+    var area = length * width
+    var perimeter = (length + width) * 2
+    return area, perimeter
+}
+func main() {  
+    area, _ := rectProps(10.8, 5.6) // perimeter is discarded
+    fmt.Printf("Area %f ", area)
+}
+```
+
+在` area, _ := rectProps(10.8, 5.6) `这一行，我们仅仅获取了 `area`，而使用空指示符 `_`来忽略第二个返回值`perimeter`。