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

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

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

Swift（スウィフト）の可変長引数（Variadic Parameters）とは、「引数の数があらかじめ決まっていない関数」を作るための仕組みです。通常の関数では、渡す値の個数は固定されていますが、可変長引数を使うと、1個でも複数個でも柔軟に値を受け取れるようになります。

たとえば、「テストの点数をまとめて受け取る」「入力された数字をすべて表示する」など、データの個数が実行するまで分からない場面で特に役立ちます。プログラミング未経験の方でも、『何個あってもOKな引数』と考えるとイメージしやすいでしょう。

実際には、関数の中では可変長引数は自動的に配列として扱われます。そのため、あとから1つずつ取り出して処理することができ、初心者でも直感的に使えるのが特徴です。

func greet(names: String...) {
    for name in names {
        print("こんにちは、\(name)さん")
    }
}

この例では、namesに何人分の名前を渡しても動作します。「人数が決まっていないけれど、同じ処理をしたい」という場面で、可変長引数はとても便利な機能です。

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

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

Swiftでは、関数に渡す引数の数が決まっていない場合に「可変長引数（かへんちょうひきすう）」を使います。書き方はとてもシンプルで、引数の型の後ろに...（ピリオド3つ）を付けるだけです。これにより、0個でも複数個でも値を受け取れる関数を定義できます。

たとえば、整数をいくつでも受け取り、順番に表示する関数は次のように書けます。

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

Int...と書かれた引数は、関数の中では配列（[Int]）として扱われます。そのため、for文を使って1つずつ取り出すことができます。

呼び出す側では、配列を意識する必要はなく、次のように値をカンマ区切りで並べるだけでOKです。

printNumbers(numbers: 1, 3, 5, 7)

このように、可変長引数を使うと「いくつ渡されるか分からない値」を柔軟に受け取れるため、初心者の方でも使いやすく、実用的な関数を簡単に作れるのが特徴です。

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

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

ここでは、先ほど作成したprintNumbers関数を実際に呼び出して動きを確認してみましょう。 この関数のポイントは、数字をいくつでもまとめて渡せる点です。 プログラミングが初めての方でも、「カンマ区切りで数字を書くと、順番に処理される」と考えればOKです。

まずは、少ない数字から試してみます。関数に渡した数字は、上から順番に1つずつ表示されます。

printNumbers(numbers: 1, 2, 3)

次に、渡す数字の数を変えてみましょう。数が増えても、特別な書き方は必要ありません。

printNumbers(numbers: 10, 20)
printNumbers(numbers: 100)

このように、printNumbers関数は「数字が何個あるか」を気にせず使えます。 実行すると、次のようにすべての数字が順番に表示されます。

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文を使って合計を求める流れも自然に理解できます。