Go 函数返回值

很多时候,函数完成内部的计算或处理任务后,还需要把结果交还给调用处继续使用,这个结果就是函数的 “返回值”。

与 C、Java 等语言不同,Go 语言的函数不仅支持返回单个值,还原生支持同时返回多个值,日常开发用起来非常灵活。

返回单个值

在 Go 语言中,如果希望函数返回一个结果,我们需要在参数小括号后面写明返回值类型,并在函数体内部使用 return 关键字把结果返回出去。其中,return 是英文单词 “返回、归还” 的意思。

语法:

func 函数名(参数列表) 返回值类型 {
    // 函数体
    return 返回值
}

说明:

当函数只返回一个值时,返回值类型直接写在参数小括号后面即可。需要注意的是,return 后面跟的值或表达式,数据类型必须与声明的返回值类型保持一致。

示例 1:函数返回单个值

package main

import "fmt"

// 返回两个整数中的较大值
func getMax(a, b int) int {
    if a > b {
        return a
    }
    return b
}

func main() {
    m := getMax(18, 25)
    fmt.Println(m)
}

运行结果如下。

25

分析:

在 func getMax(a, b int) int 中,参数小括号后面的 int 表示该函数会返回一个整型结果。进入函数后,我们先判断 a > b:如果成立,就直接执行 return a 返回 a;否则执行下面的 return b 返回 b。

需要注意的是,只要函数声明了返回值类型,我们就必须保证每一条执行路径最后都有 return 语句。如果只在 if 分支里写了 return a,却漏掉了函数末尾的 return b,编译时会直接报 missing return(缺少返回语句)错误。下面这种写法就是错误的。

func getMax(a, b int) int {
    if a > b {
        return a
    }
    // 缺少 return 语句
}

返回多个值

在实际开发中,我们经常需要让一个函数同时返回多项数据。比如同时算出长方形的面积和周长,或者在执行操作后同时返回 “处理结果” 和 “执行状态”。在 Go 语言中,函数可以直接返回多个值。

语法:

func 函数名(参数列表) (类型1, 类型2) {
    // 函数体
    return 值1, 值2
}

说明:

当函数返回 2 个及以上的值时,返回值类型列表必须用一对小括号 () 括起来,多个类型之间用英文逗号(,)隔开。同时,在 return 后面也要按相同顺序写出多个返回值,中间同样用英文逗号隔开。

示例 2:函数返回多个值

package main

import "fmt"

// 同时返回长方形的面积与周长
func calcRect(width, height int) (int, int) {
    area := width * height
    perimeter := (width + height) * 2
    return area, perimeter
}

func main() {
    area, perimeter := calcRect(5, 3)
    fmt.Println(area, perimeter)
}

运行结果如下。

15 16

分析:

在这个例子中,calcRect(width, height int) (int, int) 表示该函数执行后会同时返回两个 int 类型的值。函数体内部的 return area, perimeter 把面积 15 作为第 1 个返回值,把周长 16 作为第 2 个返回值一并返回。

在 main() 函数中调用 calcRect(5, 3) 时,我们在 := 左边写了 area, perimeter 两个变量,按顺序接收这两个结果。小伙伴们要特别留意,只要返回值达到 2 个及以上,返回值类型列表外层就不能漏掉小括号。

// 正确方式
func calcRect(width, height int) (int, int) {
    return width * height, (width + height) * 2
}

// 错误方式
func calcRect(width, height int) int, int {
    return width * height, (width + height) * 2
}

多返回值的类型并不要求完全相同。在实际开发中,我们经常把 “计算结果” 和 “表示是否成功的布尔值” 一起返回,这和前面 Map 判断键是否存在时同时返回 “值与存在状态” 是一样的思路。

示例 3:返回不同类型的多个值

package main

import "fmt"

// 同时返回除法结果与是否计算成功
func divide(a, b float64) (float64, bool) {
    if b == 0 {
        return 0, false
    }
    return a / b, true
}

func main() {
    res, ok := divide(10, 2)
    fmt.Println(res, ok)

    res2, ok2 := divide(10, 0)
    if !ok2 {
        fmt.Printf("除数不能为 0,返回结果:%.0f\n", res2)
    }
}

运行结果如下。

5 true
除数不能为 0,返回结果:0

分析:

divide() 函数的返回值类型为 (float64, bool)。当我们第 1 次调用 divide(10, 2) 时,除数不为 0,函数正常返回商 5 和 true。

当我们第 2 次调用 divide(10, 0) 时,触发了 b == 0 判断,函数返回 0 和 false,外层通过判断 !ok2 就能及时拦截异常。后面学习 Go 语言的错误处理时,小伙伴们也会大量见到这种 “结果 + 状态” 的多返回值写法。

另外,如果完全不需要接收返回值,我们可以直接单独写 calcRect(5, 3)。但只要在左边定义变量接收多返回值,变量个数就必须与返回值个数保持一致,不能只写 area := calcRect(5, 3)。

如果只想要其中一个返回值,另一个用不到,应该怎么办呢?这时可以使用匿名变量 _ 把不需要的返回值占位忽略掉,这和我们在 for range 循环中使用下划线(_)忽略下标是一样的道理。下面我们来看一个例子。

示例 4:使用 _ 忽略返回值

package main

import "fmt"

func calcRect(width, height int) (int, int) {
    return width * height, (width + height) * 2
}

func main() {
    // 只接收面积,使用 _ 忽略周长
    area, _ := calcRect(5, 3)
    fmt.Println(area)
}

运行结果如下。

15

分析:

area, _ := calcRect(5, 3) 表示用变量 area 接收第 1 个返回值,并把第 2 个返回值交给 _ 直接丢弃。反过来,如果只需要第 2 个返回值周长,写成 _, perimeter := calcRect(5, 3) 即可,编译器不会报 “变量未使用” 错误。

命名返回值(了解)

定义函数时,我们除了指定返回值的类型之外,还可以在返回值小括号里提前给返回值起好变量名,这种写法叫做 “命名返回值”。

语法:

func 函数名(参数列表) (返回值名1 类型1, 返回值名2 类型2) {
    返回值名1 = 值1
    返回值名2 = 值2
    return
}

说明:

命名返回值就相当于在函数体最开头,提前帮我们声明好了这几个返回值变量,并自动初始化为对应类型的默认零值。当函数执行到最后的 return 时,即使后面什么都不写,Go 语言也会自动把这几个命名返回值变量当前的值返回出去。

示例 5:使用命名返回值

package main

import "fmt"

// 命名返回值 area 和 perimeter
func calcRect(width, height int) (area, perimeter int) {
    area = width * height
    perimeter = (width + height) * 2
    return
}

func main() {
    a, p := calcRect(5, 3)
    fmt.Println(a, p)
}

运行结果如下。

15 16

分析:

对比示例 2 可以看出,这里我们把返回值部分写成了 (area, perimeter int),相当于提前声明了两个 int 类型的返回值变量。由于它们都是 int 类型,这里跟声明函数参数时的规则一样,采用了同类型合并简写。

进入函数体时,area 和 perimeter 已经声明好了,直接用赋值号(=)给它们赋值即可。小伙伴们注意不要再写成短变量声明 area := width * height,否则编译器会报重复声明错误。

同时要留意,如果在某个分支里忘了给它们赋值就直接 return,函数会把它们初始化时的默认零值(这里是 0)返回出去。

提示: 即使定义了命名返回值,我们在 return 后面明确写出变量名(如 return area, perimeter)也是完全允许的。在实际开发中,当函数代码较长时,明确写出返回的变量名比单独写一个空 return 更容易看懂,代码可读性更高。

使用 return 提前结束函数

对于没有返回值的函数来说,是不是就不能使用 return 语句了呢?实际上并非如此。在没有返回值的函数中,我们可以单独写一个空的 return 语句,用来提前结束函数的执行。

也就是说,不论函数有没有返回值,只要程序遇到 return 语句就会立即退出当前函数,写在 return 后面的代码都不会再执行。

示例 6:使用 return 提前退出

package main

import "fmt"

func printPositive(n int) {
    if n <= 0 {
        fmt.Println("参数必须大于 0")
        return
    }
    fmt.Printf("正数:%d\n", n)
}

func main() {
    printPositive(-5)
    printPositive(10)
}

运行结果如下。

参数必须大于 0
正数:10

分析:

在这个例子中,printPositive() 是一个没有返回值的函数。当我们第 1 次调用 printPositive(-5) 时,-5 <= 0 条件成立,程序打印提示语后遇到 return 就会立即退出,下方的打印代码不会执行。

当我们第 2 次调用 printPositive(10) 时,if 条件不成立,程序继续往下执行并输出了 "正数:10"。在实际开发中,我们经常用这种方式在函数开头先校验参数是否合法,一旦不符合要求就直接 return 退出,避免把正常逻辑套进层层 if...else 缩进里。

上一篇:

下一篇:

给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号