Swiftの可変長引数（Variadic Parameters）とは？初心者向けにやさしく解説！

1. Swiftの可変長引数（Variadic Parameters）とは？

1. Swiftの可変長引数（Variadic Parameters）とは？

Swift（スウィフト）の関数では、引数の数が決まっていない場合に『可変長引数』という機能を使うことができます。これは、関数に「何個でも」値を渡せる便利な書き方です。

たとえば、「1つでも2つでも10個でも数字を受け取って、合計を出す」ような関数を作るときに使います。

2. 可変長引数の書き方と基本構文

2. 可変長引数の書き方と基本構文

Swiftで可変長引数を使うには、引数の型の前に...（ピリオド3つ）を付けます。たとえば、整数を何個でも受け取る関数は次のように書きます。

func printNumbers(numbers: Int...) {
    for number in numbers {
        print(number)
    }
}

このようにInt...と書くと、関数を呼び出すときに何個でもIntの値を渡せます。

3. 実際に使ってみよう：数字を表示する関数

3. 実際に使ってみよう：数字を表示する関数

さきほど紹介したprintNumbers関数を使って、いろいろな数を渡してみましょう。

printNumbers(numbers: 1, 2, 3)
printNumbers(numbers: 10, 20)
printNumbers(numbers: 100)

このように、渡す数の個数に制限がありません。実行結果は以下のようになります。

1
2
3
10
20
100

4. 可変長引数の中身は配列になる

4. 可変長引数の中身は配列になる

可変長引数は、関数の中では自動的に「配列（はいれつ）」として扱われます。配列とは、複数のデータをまとめて持てる箱のようなものです。

だから、for文で繰り返し処理をしたり、合計を出したりすることが簡単にできます。

func sumNumbers(numbers: Int...) -> Int {
    var total = 0
    for number in numbers {
        total += number
    }
    return total
}

この関数は、渡された数字をすべて足し算して、合計を返します。

let result = sumNumbers(numbers: 5, 10, 15)
print(result)

30

5. 可変長引数は複数指定できる？

5. 可変長引数は複数指定できる？

可変長引数は、1つの関数の中で1回だけ使うことができます。つまり、複数の可変長引数を同時に使うことはできません。

以下のように書くとエラーになります：

func invalidFunction(a: Int..., b: Int...) {
    // これはエラーになる
}

代わりに、通常の引数と可変長引数を組み合わせて使うことは可能です。ただし、可変長引数は最後に書く必要があります。

func showInfo(name: String, scores: Int...) {
    print("名前: \(name)")
    for score in scores {
        print("点数: \(score)")
    }
}

showInfo(name: "田中", scores: 80, 90, 100)

名前: 田中
点数: 80
点数: 90
点数: 100

6. 可変長引数はどんなときに使う？

6. 可変長引数はどんなときに使う？

可変長引数は、以下のようなときに使うと便利です：

• 合計や平均など、まとめて計算したいとき
• ログ出力やメッセージ表示など、柔軟に値を受け取りたいとき
• データの件数が決まっていないとき

たとえば、電卓アプリや成績計算プログラムなど、さまざまなアプリで活用できます。

7. Swiftの関数設計で知っておきたい注意点

7. Swiftの関数設計で知っておきたい注意点

初心者の方は、つい便利だからと何でもかんでも可変長引数にしてしまいがちですが、すべてに使うのはおすすめしません。

なぜなら、引数が配列になるため、型のミスや意味の分かりにくいコードになりやすいからです。設計の意図に合っている場合のみ使いましょう。

まとめ

まとめ

Swiftの可変長引数について学んできた内容を振り返ると、この仕組みがいかに柔軟で便利な関数設計を実現する重要な要素かが自然と理解できてきます。可変長引数は、引数の数が決まっていない処理を作るときにとても役立つ仕組みで、受け取る値の個数に制限がないため、さまざまな種類のアプリケーションで活用されます。関数に可変長引数を設定することで、複数の数値の合計を計算したり、複数のメッセージをまとめて処理したり、入力されるデータがその時々で異なる場合でも柔軟に対応できます。配列として扱えるため、ループ処理や集計処理との相性も良く、コード全体の見通しをよくすることにもつながります。 可変長引数はInt...やString...のように型の後ろにピリオド3つを付けるだけで簡単に利用でき、通常の引数と組み合わせることもできます。ただし、可変長引数は関数の中で一つだけという制限があり、複数並べることはできません。そのため、関数の設計をする際には、どの引数を可変長にするか慎重に考える必要があります。とはいえ、一度理解して使いこなせば、処理の柔軟性は格段に広がり、Swiftの関数設計をより快適にしてくれます。 さらに、可変長引数は具体的な実用例として、合計値の計算、点数リストの受け取り、ログメッセージの一覧表示など、多岐にわたります。特に初心者がつまずきやすい「配列の扱いやすさ」という部分を自然に身につけられるよい練習にもなります。以下のサンプルコードでは、可変長引数を使った実践的な計算処理を追加し、Swiftにおける柔軟な関数設計のコツを感じられるように構成しています。

サンプルプログラム：可変長引数で平均値を計算する

func average(values: Double...) -> Double {
    if values.isEmpty {
        return 0.0
    }
    var total: Double = 0
    for value in values {
        total += value
    }
    return total / Double(values.count)
}

let avg1 = average(values: 10, 20, 30)
let avg2 = average(values: 5.5, 7.5, 9.5, 11.5)
print(avg1) // 出力：20.0
print(avg2) // 出力：8.5

この例では、受け取った複数の値を合計し、それを件数で割ることで平均を計算する関数を示しています。可変長引数によって、値の数を気にせずに柔軟な計算処理を書くことができ、非常に使い勝手の良い関数になります。可変長引数の特徴である「配列として扱える」という性質を活かし、for文を使って合計を求める流れも自然に理解できます。