カテゴリ: Ruby 更新日: 2026/01/07

Rubyの配列と可変長引数を完全解説!*args(スプラット)で柔軟なAPI設計を理解しよう

可変長引数とスプラット:*args で柔軟なAPI設計をする
可変長引数とスプラット:*args で柔軟なAPI設計をする

先生と生徒の会話形式で理解しよう

生徒

「Rubyで引数の数が決まっていないメソッドって作れるんですか?」

先生

「できます。Rubyでは配列とスプラット演算子を使うことで、数が自由な引数を受け取れます。」

生徒

「配列と関係があるんですか?パソコンもまだ慣れてなくて…」

先生

「大丈夫です。身近なたとえを使って、最初から順番に説明します。」

1. 可変長引数とは何か?配列との深い関係

1. 可変長引数とは何か?配列との深い関係
1. 可変長引数とは何か?配列との深い関係

Rubyの可変長引数とは、「引数の数が決まっていないメソッド」を作るための仕組みです。 引数とは、メソッドに渡す情報のことです。たとえば電卓に数字を入力するようなイメージです。

普通のメソッドでは、受け取れる引数の数はあらかじめ決まっています。 しかし、実際のプログラムでは「何個データが来るかわからない」場面がよくあります。 そこで活躍するのが、Rubyの配列と*args(スプラット)です。

スプラットとは、たくさんの値をひとまとめにして配列として受け取る仕組みです。 買い物袋に商品をまとめて入れる感覚に近いです。

2. *args(スプラット)の基本的な使い方

2. *args(スプラット)の基本的な使い方
2. *args(スプラット)の基本的な使い方

Rubyでは、メソッドの引数名の前に「*」を付けることで、 何個でも値を受け取れるようになります。このとき、受け取った値は配列になります。


def show_items(*items)
  p items
end

show_items(1, 2, 3)

実行結果は次のようになります。


[1, 2, 3]

このように、複数の値が自動的に配列にまとめられています。 Rubyの配列(Array)の仕組みを理解していると、とても自然に使える機能です。

3. 配列を渡す側でも使えるスプラット

3. 配列を渡す側でも使えるスプラット
3. 配列を渡す側でも使えるスプラット

スプラットは、受け取るときだけでなく、配列を展開するときにも使えます。 これは「配列の中身をバラして渡す」動きです。


numbers = [10, 20, 30]

def total(a, b, c)
  a + b + c
end

puts total(*numbers)

60

配列の要素が順番に引数へ渡されているのがわかります。 配列とメソッドをつなぐ橋渡しのような役割をしているのがスプラットです。

4. 柔軟なAPI設計とは何か?初心者向けに解説

4. 柔軟なAPI設計とは何か?初心者向けに解説
4. 柔軟なAPI設計とは何か?初心者向けに解説

API設計とは、「使いやすい命令の形を考えること」です。 難しく聞こえますが、「何回でも使いやすい道具を作る」ことだと思ってください。

*argsを使うと、使う人が引数の数を気にせずメソッドを呼び出せます。 これは初心者にもやさしく、あとから機能を増やしやすい設計になります。

Rubyの配列は、データをまとめて扱うのが得意です。 可変長引数と組み合わせることで、無理のない自然なコードが書けるようになります。

5. 初心者がつまずきやすい注意点

5. 初心者がつまずきやすい注意点
5. 初心者がつまずきやすい注意点

*argsで受け取った値は必ず配列になります。 そのため、数値だと思って計算するとエラーになることがあります。 配列の中身を取り出して使う、という意識がとても大切です。

また、引数がゼロ個でもエラーにはなりません。 その場合は「空の配列」になります。箱が空っぽの状態を想像すると理解しやすいです。

関連記事:
カテゴリの一覧へ
新着記事
New1
Ruby
Gemとは?RubyGemsとBundlerを初心者向けに完全解説!依存関係管理も図解でわかりやすく理解
New2
Ruby
Rubyの文字エンコーディング入門!UTF-8・マジックコメント・外部/内部エンコーディングを完全解説
New3
Rails
Rails GoodJob入門!PostgreSQLベースのバックグラウンド処理を初心者向けに完全解説
New4
Ruby
Rubyで学ぶビット演算入門:&・|・^・~・<<・>>の基礎と実例
人気記事
No.1
Java&Spring記事人気No1
Ruby
Rubyのreduceとinject入門!合計計算や集計を初心者向けに分かりやすく解説
No.2
Java&Spring記事人気No2
Ruby
Rubyの文字列エンコーディング完全ガイド!Encoding・force_encoding・encodeを初心者向け解説
No.3
Java&Spring記事人気No3
Ruby
Rubyの始め方ガイド:インストールから最初のHello Worldまで(Windows/Mac/Linux)
No.4
Java&Spring記事人気No4
データベース
PostgreSQLのWHERE句を徹底解説!初心者でもわかるSQLデータ抽出の基本
No.5
Java&Spring記事人気No5
Ruby
Rubyのfind/detect/find_indexを徹底解説!目的のデータを素早く探す方法
No.6
Java&Spring記事人気No6
Ruby
Rubyで比較演算子を完全解説!==・===・<=>・eql? の使い分け
No.7
Java&Spring記事人気No7
Ruby
Rubyのselect/reject/filterの使い方を完全解説!初心者向けの条件抽出レシピ
No.8
Java&Spring記事人気No8
データベース
PostgreSQLで順位付け!ROW_NUMBER関数の使い方を初心者向けに徹底解説