カテゴリ: 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
データベース
SQLの処理が遅くなる原因とは?初心者向けにデータベースパフォーマンス最適化を完全解説
New2
Ruby
RubyのネストHash操作を徹底解説!digとtransformメソッドで複雑なデータも楽々
New3
Rails
Railsインデックス設計の極意!爆速サイトを作るためのスキーマ設計ガイド
New4
データベース
SQLのCOMMITとROLLBACKとは?トランザクション操作を初心者向けに完全解説
人気記事
No.1
Java&Spring記事人気No1
Ruby
PATHと環境変数の正しい設定!Windows・Mac・Linux別チェックリスト付き
No.2
Java&Spring記事人気No2
Rails
Railsで日本語と時刻の設定をしよう!初心者でも安心のlocale/zone初期設定チートシート
No.3
Java&Spring記事人気No3
Ruby
Rubyのハッシュを徹底比較!シンボルキーと文字列キーの違いと使い分け
No.4
Java&Spring記事人気No4
Rails
Railsマイグレーションの型選びを完全ガイド!初心者が迷わないカラム設計
No.5
Java&Spring記事人気No5
Ruby
WindowsでRubyをインストールする方法!RubyInstallerとMSYS2を使った完全ガイド
No.6
Java&Spring記事人気No6
Rails
RailsモデルとActive Record基礎|ID戦略を完全理解!AUTO INCREMENT・UUID・ULIDの比較と導入手順
No.7
Java&Spring記事人気No7
Rails
RailsモデルとActive Record基礎|クエリログの読み方を理解してEXPLAIN・joins・includesの違いを学ぼう
No.8
Java&Spring記事人気No8
データベース
ACID特性とは?データベーストランザクションの信頼性を初心者向けに徹底解説