Rubyのキーワード引数はシンボルっぽく定義するけど、シンボルそのものではない、という話

## はじめに

拙著「[プロを目指す人のためのRuby入門](http://gihyo.jp/book/2017/978-4-7741-9397-7)（通称チェリー本）」の読者さんの中で、ときどきキーワード引数について困惑している人を見かけるので、この記事でキーワード引数に関する説明を補足しておきます。

### Ruby初心者さんの疑問：キーワード引数はシンボルじゃないの？

Ruby初心者さんの中には、キーワード引数をシンボルとして参照できないことに疑問を持つ方がおられるようです。

たとえばこんな感じです。（「[プロを目指す人のためのRuby入門](http://gihyo.jp/book/2017/978-4-7741-9397-7)」5.4.3項のコード例を一部改変）

```ruby
def buy_burger(menu, drink: true, potato: true)
  # なんで :drink じゃないの？
  if drink
    # ...
  end
  # なんで :potato じゃないの？
  if potato
    # ...
  end
end
```

なるほど、そう言われてみると、メソッド定義のキーワード引数はたしかにキーがシンボルのハッシュっぽい書き方になってますね・・・。

```ruby
# drink: true, potato: true の部分だけ見ると、
# たしかにキーがシンボルのハッシュっぽい
def buy_burger(menu, drink: true, potato: true)

# 実際、こう書けばキーがシンボルのハッシュになる
hash = { drink: true, potato: true }
hash[:drink]  #=> true
hash[:potato] #=> true
```

でも、これは記法が似ているだけであって、シンボルではないんです。
あくまでメソッドの引数（仮引数）なんです。

ですので、上のメソッドの`menu`と同じように、メソッド内では`drink`、`potato`のように参照します。

もし、`:drink`、`:potato`のように書いてしまうと、これはシンボルオブジェクト（シンボルリテラル）を書いたことになります。

```ruby
def buy_burger(menu, drink: true, potato: true)
  # キーワード引数もメソッドの引数なので、menuと同様にdrinkと書く
  if drink
    # ...
  end
  
  # :drinkと書いた場合はメソッドの引数とは無関係な、ただのシンボルオブジェクトになってしまう
  if :drink
    # ...
  end
  
  # ...
end
```

とりあえず、この点については「キーワード引数はシンボルではないんです。定義するときの書き方はたしかに似てるけど、そういうもんなんです」としか説明のしようがありません。

## なぜキーワード引数をシンボルっぽく書くのか？その歴史的経緯

とはいえ、キーワード引数をシンボルっぽく書くのは、おそらく歴史的な経緯があると考えています。

「[プロを目指す人のためのRuby入門](http://gihyo.jp/book/2017/978-4-7741-9397-7)」の5.6.3項にも書いたように、キーワード引数が導入される前（つまりRuby 1.9以前）はハッシュを使って擬似的にキーワード引数を実現していました。

```ruby
# ハッシュを引数として受け取り、疑似キーワード引数を実現する
# （キーワード引数が導入される前はこう書くしかなかった）
def buy_burger(menu, options = {})
  # 引数のハッシュから目的の値をローカル変数に格納する
  drink = options[:drink]
  potato = options[:potato]
  
  # 引数から取り出した値を使って処理を書く
  if drink
    # ...
  end
  
  # ...
end

# このメソッド呼び出しではキーワード引数ではなく、
# { drink: true, potato: true } というハッシュオブジェクトを
# 引数として渡している
buy_burger('cheese', drink: true, potato: true)
```

このようにRubyの世界では昔からハッシュとキーワード引数が近しい関係にあったため、キーワード引数の定義の仕方もハッシュの記法に似たものになったのだろう、と僕は考えています。

```ruby
# 昔はみんなハッシュで書いてたんだから・・・
def buy_burger(menu, options = {})
  # ...
end

# キーワード引数もハッシュっぽい記法になっていると自然(?)
def buy_burger(menu, drink: true, potato: true)
  # キーワード引数にすると、このローカル変数が引数に置きかわるイメージ
  # drink = options[:drink]
  # potato = options[:potato]
  
  if drink
    # ...
  end
  
  # ...
end

# ちなみに、呼び出し方はどちらも変わりません
buy_burger('cheese', drink: true, potato: true)
```

ただ、この歴史的経緯を知っている人にとっては「うん、自然だね」と思えるものの、そうじゃない人にとっては「えっ、なんでシンボルじゃないの！？」とビックリする原因になるのかもしれませんね。

## 2020.5.7 追記：呼び出し側はシンボルなの？シンボルじゃないの？
この記事ではあくまで「メソッドを定義する側」に議論をフォーカスしています。

しかし、「シンボルそのものではない」ということを強調しすぎたがゆえに、メソッド呼び出し側の話と混同されている方も中にはおられるようです。

```ruby
# drink: や potato: はシンボルなの？シンボルじゃないの？？
buy_burger('cheese', drink: true, potato: true)
```

ややこしいですが、メソッド呼び出し側に登場する引数については「シンボルだ」と言ってもよいと思います。
なぜなら、メソッド定義側と異なり、呼び出し側は`=>`を使って呼び出すこともできるからです。
よって、シンボルそのもの（シンボルのリテラル）を書いていることになります。

```ruby
# 呼び出す側はどっちの記法でも呼び出せる
buy_burger('cheese', drink: true, potato: true)
buy_burger('cheese', :drink => true, :potato => true)
```

また、シンボルを変数に格納しても呼び出せます。
このことからも呼び出し側は「シンボルを渡している」と言えると思います。

```ruby
# 変数経由で呼び出すこともできる
key_1 = :drink
key_2 = :potato
buy_burger('cheese', key_1 => true, key_2 => true)
```

とはいえ、「呼び出す側はシンボルとして引数を渡すが、受け取る側はシンボルでない普通のメソッド引数として値を受け取る」というのは、言われてみると不自然な気もしますね。
僕はこれまで「これはこういうものだ」と考えていたので、あまり疑問に思いませんでしたが、「そう言われてみると、なるほどな〜」と思いました。

## まとめ
というわけで、この記事では「Rubyのキーワード引数はシンボルっぽく定義するけど、シンボルそのものではない」という話を説明しました。

「[プロを目指す人のためのRuby入門](http://gihyo.jp/book/2017/978-4-7741-9397-7)」の改訂版を出す機会があれば、この内容も追加しておこうと思います。
それまではこの記事を参考にしてもらえると幸いです。

### あわせて読みたい

Ruby 2.0でキーワード引数が導入されたときに書かれた記事です。
上で説明した「歴史的経緯」をより詳しく理解することができます。

- [Ruby 2\.0\.0 のキーワード引数](https://magazine.rubyist.net/articles/0041/0041-200Special-kwarg.html)

一方で、この「歴史的経緯」が原因で、Ruby本体のややこしい不具合の原因になってしまったという問題もあります。
そのため、Ruby 2.7以降ではキーワード引数の扱いが変更されています。
詳しくはこちらの記事をご覧ください。

- [Ruby 2\.7で発生する「プロを目指す人のためのRuby入門」との差異について \- Qiita](https://qiita.com/jnchito/items/aa4ebf6f0e363a1b8098#_reference-18544d0a5c9e484ffbab)
- [サンプルコードでわかる！Ruby 2\.7の主な新機能と変更点 Part 2 \- キーワード引数に関する仕様変更 \- Qiita](https://qiita.com/jnchito/items/c15ac23791e0320e0fc2)