可変長引数

「同じ種類の値を、個数を決めずに関数に渡したい」場面はよくあります。たとえば「渡された整数をすべて足し合わせる sum 関数」を作りたいときです。

これまで学んだ書き方だと、事前にスライスを組み立ててから関数に渡すことになります。

package main

import "fmt"

func sum(nums []int) int {
    total := 0
    for _, n := range nums {
        total += n
    }
    return total
}

func main() {
    fmt.Println(sum([]int{1, 2, 3}))
    fmt.Println(sum([]int{10, 20, 30, 40, 50}))
}

以下のような実行結果が表示されます。

6
150

動きはしますが、呼び出す側で毎回 []int{...} とスライスを作るのが少し冗長です。

このような場面のために、関数の最後の引数を ...型 と書くと、任意の個数の値を直接受け取れる可変長引数の書き方が用意されています。書き方は以下のとおりです。

func 関数名(引数名 ...型) 戻り値の型 {
    // 処理(引数名は []型 として扱える)
}

先ほどの sum を可変長引数で書き直すと、次のようになります。

package main

import "fmt"

func sum(nums ...int) int {
    total := 0
    for _, n := range nums {
        total += n
    }
    return total
}

func main() {
    fmt.Println(sum(1, 2, 3))
    fmt.Println(sum(10, 20, 30, 40, 50))
}

以下のような実行結果が表示されます。

6
150

同じ結果が得られました。呼び出し側は sum(1, 2, 3) のように、値を直接カンマ区切りで渡すだけで済むようになっています。

コードを解説します。

func sum(nums ...int) int {
    total := 0
    for _, n := range nums {
        total += n
    }
    return total
}

nums ...int は「任意の個数の int 型引数を受け取る」の意味で、関数内では nums は []int として扱われます。中の処理は先ほどと同じで、for-range で1つずつ取り出して total に加算しています。

fmt.Println(sum(1, 2, 3))
fmt.Println(sum(10, 20, 30, 40, 50))

呼び出し側は、引数をカンマ区切りで任意の個数渡せます。fmt.Println や fmt.Printf も可変長引数を使った関数の一例です。