【Ruby】レッスン5-10：モジュールの使い方と定義方法を理解しよう
一つ前のページではオーバーライドについて学習しました。
今回は モジュール について見ていきましょう。
Lesson１：基礎文法編
Lesson２：制御構造編
Lesson３：メソッド編
Lesson４：コレクション編
Lesson５：オブジェクト指向編
・Lesson5-1：クラスの基本を理解しよう
・Lesson5-2：イニシャライザを理解しよう
・Lesson5-3：アクセスメソッドを理解しよう
・Lesson5-4：クラス変数とクラスメソッドを理解しよう
・Lesson5-5：privateメソッドを理解しよう
・Lesson5-6：正規表現を理解しよう
・Lesson5-7：クラスの継承を理解しよう
・Lesson5-8：ファイル操作を理解しよう
・Lesson5-9：オーバーライドを理解しよう
・Lesson5-10：モジュールを使ってみよう ◁今回はココ
・Lesson5-11：ミックスインを使ってみよう
・確認問題5-☆1：モンスター捕獲ゲームを作ろう
・確認問題5-☆2：モンスターとの戦闘ゲームを作ろう
・確認問題5-☆3：マルバツゲームを作ろう
<<前のページ
Rubyの記事一覧
次のページ>>
Rubyのモジュール文法を基礎から学ぼう
Rubyではモジュールを使うことでコードの再利用性を高めたり、名前空間を整理したりすることができます。
モジュールはクラスとは異なりインスタンス化はできませんが、クラスに共通の機能を提供するために非常に便利な仕組みです。
本記事ではモジュールの定義と使用方法について学びます。
Rubyにおけるモジュールの基本とは
モジュールとは、クラスとは異なる方法で機能をまとめる仕組みです。
クラスのようにデータやメソッドを保持できますが、インスタンスを作成することはできません。
モジュールの主な用途は以下の2つです。
- 名前空間としての利用：同じ名前のクラスやメソッドが衝突しないように整理します。
- Mixinとしての利用：複数のクラスで共有されるメソッドを提供します。
モジュールはコードの可読性を向上させ、変更に強い設計を実現するために活用されます。
Rubyでモジュールを定義する方法
モジュールを定義するにはmoduleキーワードを使用します。
以下に基本的なモジュール定義の例を示します。
module Greeting # Greetingモジュールの定義
def say_hello # say_helloメソッドの定義
puts "Hello!" # say_helloメソッドの処理内容
end
endこの例ではGreetingという名前のモジュールを定義し、その中にsay_helloメソッドを含めています。
モジュールの名前は通常、キャメルケース（先頭を大文字にする形式）で記述します。
モジュールをincludeしてクラスに機能を追加する方法
モジュールを利用するには以下の方法があります。
インクルード（include）を使用する
includeを使用すると、モジュール内のメソッドがクラスのインスタンスメソッドとして使用可能になります。
module Greeting # Greetingモジュールの定義
def say_hello
puts "Hello!"
end
end
class User
include Greeting # Greetingモジュールをインクルード
end
user = User.new # インスタンス生成
user.say_hello # => "Hello!"
# includeはインスタンスメソッドを追加するため、インスタンス化が必要エクステンド（extend）を使用する
extendを使用すると、モジュール内のメソッドがクラスのクラスメソッドとして使用可能になります。
module Greeting # Greetingモジュールの定義
def say_hello
puts "Hello!"
end
end
class User
extend Greeting # Greetingモジュールをエクステンド
end
User.say_hello # => "Hello!"
# extendはクラスそのものにメソッドを追加するため、クラスから直接呼び出すことが可能実例で学ぶモジュールの活用方法
以下は現実的なシナリオでのモジュール使用例です。
たとえばログ機能を提供するモジュールを作成します。
module Logger # Loggerモジュールの定義
def log_info(message)
puts "[INFO] #{message}"
end
end
class Application # Applicationクラスの定義
include Logger # Loggerモジュールをインクルード
end
app = Application.new # インスタンス生成
app.log_info("アプリケーションが起動しました") # => [INFO] アプリケーションが起動しましたこの例ではLoggerモジュールをApplicationクラスにインクルードすることで、log_infoメソッドを簡単に再利用できます。
まとめ
モジュールはコードの再利用性を高める強力なツールです。
名前空間の整理や共通のメソッドの共有など、多くの場面で役立ちます。
次回はモジュールを使った高度な技術であるミックスインについて学びます。
これを理解することでRubyにおけるオブジェクト指向設計の基礎をさらに深めることができます。
練習問題｜モジュールで単位換算プログラムを作成しよう
モジュールをしっかりと身に着けるため、練習問題に挑戦しましょう。
単位換算でモジュールの理解を深めよう
距離と重さの単位換算を行うプログラムを作成しましょう。
ユーザーが入力した数値を以下のように換算させます。
- キロメートル ⇔ マイル
- キログラム ⇔ ポンド
各換算機能はモジュールとして定義され、メインの換算クラスで使用されます。
以下の要件に従ってコードを完成させてください。
DistanceConverterモジュールを定義し、キロメートルをマイルに換算するメソッドとマイルをキロメートルに換算するメソッドを持つこと。WeightConverterモジュールを定義し、キログラムをポンドに換算するメソッドとポンドをキログラムに換算するメソッドを持つこと。Converterクラスを定義し、ユーザーからの入力を受け取り、適切な単位換算を行うメソッドを実装すること。- コンストラクタを使って、必要な初期化を行うこと。
- ユーザーからの入力を利用して、単位換算機能を実行し、結果を表示すること。
- 1キロメートル = 0.621371マイル、1マイル = 1.60934キロメートル
- 1キログラム = 2.20462ポンド、1ポンド = 0.453592キログラム
ただし、以下のような実行結果となること。
単位換算プログラムを初期化しました。 換算したい単位を選択してください: 1. キロメートルをマイル, 2. マイルをキロメートル, 3. キログラムをポンド, 4. ポンドをキログラム 1 キロメートルを入力してください: 10 結果: 6.21371 マイル 続けますか？ (y/n) y 換算したい単位を選択してください: 1. キロメートルをマイル, 2. マイルをキロメートル, 3. キログラムをポンド, 4. ポンドをキログラム 3 キログラムを入力してください: 5 結果: 11.0231 ポンド 続けますか？ (y/n) n 単位換算プログラムを終了します。
【ヒント】自力で解くのが難しい人へ
１からコードを組み立てることが難しい場合は、以下のヒントを開いて参考にしましょう。
- ヒント１【コードの構成を見る】
-
正解のコードは上から順に以下のような構成となっています。
１：DistanceConverterモジュールを定義
□ 定数KM_TO_MILESを定義
□ 定数MILES_TO_KMを定義
□ メソッドkm_to_milesを定義
□ □ キロメートルをマイルに換算して戻り値として返す
□ メソッドmiles_to_kmを定義
□ □ マイルをキロメートルに換算して戻り値として返す２：WeightConverterモジュールを定義
□ 定数KG_TO_POUNDSを定義
□ 定数POUNDS_TO_KGを定義
□ メソッドkg_to_poundsを定義
□ □ キログラムをポンドに換算して戻り値として返す
□ メソッドpounds_to_kgを定義
□ □ ポンドをキログラムに換算して戻り値として返す３：Converterクラスを定義
□ initializeメソッドを定義
□ □ 初期化時に「単位換算プログラムを初期化しました。」と出力
□ perform_conversionメソッドを定義
□ □ 換算の選択肢を表示
□ □ ユーザーの入力を取得
□ □ case文でchoiceの値を判定
□ □ □ choiceが1の場合、「キロメートルを入力してください:」と表示
□ □ □ ユーザーの入力を取得してkmに代入
□ □ □ DistanceConverter.km_to_milesの結果を出力
□ □ □ choiceが2の場合、「マイルを入力してください:」と表示
□ □ □ ユーザーの入力を取得してmilesに代入
□ □ □ DistanceConverter.miles_to_kmの結果を出力
□ □ □ choiceが3の場合、「キログラムを入力してください:」と表示
□ □ □ ユーザーの入力を取得してkgに代入
□ □ □ WeightConverter.kg_to_poundsの結果を出力
□ □ □ choiceが4の場合、「ポンドを入力してください:」と表示
□ □ □ ユーザーの入力を取得してpoundsに代入
□ □ □ WeightConverter.pounds_to_kgの結果を出力
□ □ □ choiceがその他の場合、「無効な選択です。もう一度試してください。」と表示４：メインプログラムを開始
□ Converterクラスのインスタンスを生成して変数converterに代入
□ 変数continueに’y’を代入
□ while文を定義（continueが’y’の間繰り返す）
□ □ converter.perform_conversionを呼び出す
□ □ 「続けますか？ (y/n)」と出力
□ □ ユーザーの入力をcontinueに代入
□ 「単位換算プログラムを終了します。」と出力
- ヒント２【穴埋め問題にする】
-
以下のコードをコピーし、コメントに従ってコードを完成させて下さい。
# 距離の単位換算を定義するモジュール =begin 【穴埋め問題1】 ここにDistanceConverterモジュールを定義し、以下の内容を記述してください： - 定数KM_TO_MILESに0.621371を代入 - 定数MILES_TO_KMに1.60934を代入 - メソッドkm_to_milesを定義し、キロメートルをマイルに換算して戻り値として返す - メソッドmiles_to_kmを定義し、マイルをキロメートルに換算して戻り値として返す =end # 重さの単位換算を定義するモジュール =begin 【穴埋め問題2】 ここにWeightConverterモジュールを定義し、以下の内容を記述してください： - 定数KG_TO_POUNDSに2.20462を代入 - 定数POUNDS_TO_KGに0.453592を代入 - メソッドkg_to_poundsを定義し、キログラムをポンドに換算して戻り値として返す - メソッドpounds_to_kgを定義し、ポンドをキログラムに換算して戻り値として返す =end # 単位換算を行うクラス class Converter def initialize puts "単位換算プログラムを初期化しました。" end # ユーザーの入力を受け取り、適切な単位換算を行うメソッド def perform_conversion puts "換算したい単位を選択してください: 1. キロメートルをマイル, 2. マイルをキロメートル, 3. キログラムをポンド, 4. ポンドをキログラム" choice = gets.chomp.to_i case choice when 1 puts "キロメートルを入力してください:" km = gets.to_f =begin 【穴埋め問題3】 ここにDistanceConverterモジュールを使用して、kmをマイルに換算するコードを書いてください。 結果は「結果: ○○ マイル」と出力してください。 =end when 2 puts "マイルを入力してください:" miles = gets.to_f =begin 【穴埋め問題4】 ここにDistanceConverterモジュールを使用して、milesをキロメートルに換算するコードを書いてください。 結果は「結果: ○○ キロメートル」と出力してください。 =end when 3 puts "キログラムを入力してください:" kg = gets.to_f =begin 【穴埋め問題5】 ここにWeightConverterモジュールを使用して、kgをポンドに換算するコードを書いてください。 結果は「結果: ○○ ポンド」と出力してください。 =end when 4 puts "ポンドを入力してください:" pounds = gets.to_f =begin 【穴埋め問題6】 ここにWeightConverterモジュールを使用して、poundsをキログラムに換算するコードを書いてください。 結果は「結果: ○○ キログラム」と出力してください。 =end else puts "無効な選択です。もう一度試してください。" end end end # メインプログラム converter = Converter.new continue = 'y' while continue.downcase == 'y' converter.perform_conversion puts "続けますか？ (y/n)" continue = gets.chomp end puts "単位換算プログラムを終了します。"
このヒントを見てもまだ回答を導き出すのが難しいと感じる場合は、先に正解のコードと解説を見て内容を理解するようにしましょう。
この問題の解答例と解説
この問題の正解コードとその解説は以下の通りです。
クリックして開いて確認してください。
- 正解コード
-
# 距離の単位換算を定義するモジュール module DistanceConverter KM_TO_MILES = 0.621371 MILES_TO_KM = 1.60934 def self.km_to_miles(km) km * KM_TO_MILES end def self.miles_to_km(miles) miles * MILES_TO_KM end end # 重さの単位換算を定義するモジュール module WeightConverter KG_TO_POUNDS = 2.20462 POUNDS_TO_KG = 0.453592 def self.kg_to_pounds(kg) kg * KG_TO_POUNDS end def self.pounds_to_kg(pounds) pounds * POUNDS_TO_KG end end # 単位換算を行うクラス class Converter def initialize puts "単位換算プログラムを初期化しました。" end # ユーザーの入力を受け取り、適切な単位換算を行うメソッド def perform_conversion puts "換算したい単位を選択してください: 1. キロメートルをマイル, 2. マイルをキロメートル, 3. キログラムをポンド, 4. ポンドをキログラム" choice = gets.chomp.to_i case choice when 1 puts "キロメートルを入力してください:" km = gets.to_f puts "結果: #{DistanceConverter.km_to_miles(km)} マイル" when 2 puts "マイルを入力してください:" miles = gets.to_f puts "結果: #{DistanceConverter.miles_to_km(miles)} キロメートル" when 3 puts "キログラムを入力してください:" kg = gets.to_f puts "結果: #{WeightConverter.kg_to_pounds(kg)} ポンド" when 4 puts "ポンドを入力してください:" pounds = gets.to_f puts "結果: #{WeightConverter.pounds_to_kg(pounds)} キログラム" else puts "無効な選択です。もう一度試してください。" end end end # メインプログラム converter = Converter.new continue = 'y' while continue.downcase == 'y' converter.perform_conversion puts "続けますか？ (y/n)" continue = gets.chomp end puts "単位換算プログラムを終了します。"
- 正解コードの解説
-
コードをブロックごとに分割して解説します。
DistanceConverterモジュール
module DistanceConverter KM_TO_MILES = 0.621371 MILES_TO_KM = 1.60934 def self.km_to_miles(km) km * KM_TO_MILES end def self.miles_to_km(miles) miles * MILES_TO_KM end endmodule: Rubyでモジュールを定義する構文。モジュールは関連するメソッドや定数をまとめるための機能です。KM_TO_MILES、MILES_TO_KM: 距離換算のための定数を定義しています。定数は大文字で記述するのがRubyの慣習です。self.km_to_milesとself.miles_to_km: モジュール関数として定義されています。self.を付けることでモジュール名を介して呼び出せます。
WeightConverterモジュール
module WeightConverter KG_TO_POUNDS = 2.20462 POUNDS_TO_KG = 0.453592 def self.kg_to_pounds(kg) kg * KG_TO_POUNDS end def self.pounds_to_kg(pounds) pounds * POUNDS_TO_KG end end- このモジュールは重さの単位換算を提供します。
KG_TO_POUNDSやPOUNDS_TO_KGといった定数は、キログラムとポンドの間の換算比率を示しています。- 各関数は与えられた値を適切な換算比率で計算します。
Converterクラス
class Converter def initialize puts "単位換算プログラムを初期化しました。" end def perform_conversion puts "換算したい単位を選択してください: 1. キロメートルをマイル, 2. マイルをキロメートル, 3. キログラムをポンド, 4. ポンドをキログラム" choice = gets.chomp.to_i case choice when 1 puts "キロメートルを入力してください:" km = gets.to_f puts "結果: #{DistanceConverter.km_to_miles(km)} マイル" when 2 puts "マイルを入力してください:" miles = gets.to_f puts "結果: #{DistanceConverter.miles_to_km(miles)} キロメートル" when 3 puts "キログラムを入力してください:" kg = gets.to_f puts "結果: #{WeightConverter.kg_to_pounds(kg)} ポンド" when 4 puts "ポンドを入力してください:" pounds = gets.to_f puts "結果: #{WeightConverter.pounds_to_kg(pounds)} キログラム" else puts "無効な選択です。もう一度試してください。" end end endinitializeメソッド: クラスのインスタンスを生成する際に自動で実行されます。プログラムが初期化されたことを示すメッセージを表示しています。perform_conversionメソッド: ユーザーの入力をもとに適切な単位換算を行います。gets.chomp: ユーザーからの入力を受け取ります。case文: 入力された選択肢によって異なる処理を実行します。
メインプログラム
converter = Converter.new continue = 'y' while continue.downcase == 'y' converter.perform_conversion puts "続けますか？ (y/n)" continue = gets.chomp end puts "単位換算プログラムを終了します。"
Converter.new: Converterクラスのインスタンスを生成します。whileループ: ユーザーがyと入力し続ける限り、単位換算を繰り返します。downcase: 入力された文字列を小文字に変換するメソッドです。
まとめ
このプログラムではモジュールを使って距離と重さの単位換算を簡潔に定義し、それをクラス内で利用しています。
モジュールを活用することでコードの再利用性を高め、メンテナンスしやすい設計を実現しています。
- モジュールの使い方: 共通する機能を整理し、独立した単位として管理できます。
- クラスとメソッドの利用: インスタンスメソッドとクラスメソッドの違いを理解しました。
- ユーザー入力の処理: Rubyの
getsメソッドを使って入力を受け取り、実行時に動的な動作を可能にしています。
Rubyプログラミングの基礎を理解し、このコードを参考に他の単位換算や処理を実装してみてください！
<<前のページ
Rubyの記事一覧
次のページ>>
FAQ｜Rubyのモジュールの使い方と活用法
- Q1. Rubyのモジュールはクラスとどう違うのですか？
-
モジュールはインスタンス化できない点でクラスと異なり、主に共通のメソッド群をまとめてクラスに取り込むために使います。コードの再利用性向上や機能の分離に適しています。
- Q2. Rubyでモジュールを複数のクラスに共有するにはどうすればいいですか？
-
includeやextendを使えば、1つのモジュールを複数のクラスで再利用できます。includeはインスタンスメソッドとして、extendはクラスメソッドとしてモジュールの機能を取り入れることができます。
- Q3. モジュールの中に定数やクラスを定義することは可能ですか？
-
はい、可能です。モジュール内に定数やクラスを定義することで、名前空間として利用でき、他のコードとの衝突を防ぎながら機能を整理できます。