Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Ruby3.x】Gem::Version::<=>()メソッドの使い方

<=>メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

<=>メソッドは、Gem::Versionオブジェクト同士を比較し、その関係を示す数値を返すメソッドです。このメソッドは、自身が表すバージョンと、引数として渡された別のGem::Versionオブジェクトが表すバージョンを比較します。

具体的には、以下のいずれかの数値を返します。

  • 自身が引数のバージョンより古い(小さい)場合: -1
  • 自身が引数のバージョンと同じ(等しい)場合: 0
  • 自身が引数のバージョンより新しい(大きい)場合: 1

もし引数がGem::Versionオブジェクトではない、または有効なバージョンとして比較できない場合には、nilを返します。

このメソッドは、主にソフトウェアのバージョン管理において、どのバージョンが最新であるか、あるいは特定の条件を満たしているかを確認するために利用されます。Rubyでは、この<=>メソッドを定義することで、<==>=といった他の比較演算子も自動的に利用できるようになるため、Gem::Versionオブジェクトの比較処理を効率的かつ一貫性のある方法で実現する上で非常に重要な役割を果たします。これにより、バージョンに基づいたソートや条件分岐が容易になります。

構文(syntax)

1require 'rubygems'
2
3[
4  Gem::Version.new("1.0.0") <=> Gem::Version.new("1.1.0"),
5  Gem::Version.new("1.0.0") <=> Gem::Version.new("1.0.0"),
6  Gem::Version.new("1.1.0") <=> Gem::Version.new("1.0.0")
7]

引数(parameters)

other

  • other: 比較対象のGem::Versionオブジェクト

戻り値(return)

Integerまたはnil

Gem::Version#<=> は、2つのバージョンの比較結果を返します。自身が相手より大きい場合は正の整数、等しい場合は 0、小さい場合は負の整数を返します。比較できない場合は nil を返します。

関連コンテンツ