Ruby 2.5.0 リファレンスマニュアル > ライブラリ一覧 > rubygems/versionライブラリ > Gem::Versionクラス

class Gem::Version

クラスの継承リスト: Gem::Version < Comparable < Object < Kernel < BasicObject

要約

文字列で表現されたバージョンを比較可能 (Comparable) にするためのクラスです。

バージョンを文字列で表したとき、単純に String#<=> で比較すると、 "1.9" のほうが "1.10" よりも大きい(バージョンが高い)ことになってしまい、正しく判定できません。 Gem::Version はこの問題を解決します。

文字列での比較と Gem::Version での比較

p "1.9" < "1.10" # => false
p Gem::Version.new("1.9") < Gem::Version.new("1.10") # => true

gem のバージョンを取り扱うためのクラスですが、バージョン表記が RubyGems の流儀に則っていれば RubyGems とは無関係に使うこともできます。

バージョン表記のソートの例

versions = %w[ 1.1  1.10  1.9  1.1.beta9  1.1.beta10 ]

p versions.sort_by{ |v| Gem::Version.new(v) }
# => ["1.1.beta9", "1.1.beta10", "1.1", "1.9", "1.10"]

上の例で、"1.9" と "1.10" では(数字列ではなく)整数として 9 より 10 が大きいので、"1.10" のほうが大きいと判定されています。

また、"1.1.beta9" は "beta9" の部分が数字でないものを含んでいるので "1.1" の「プレリリース」バージョンであるとみなされます。この規則により、"1.1" と "1.1.beta9" では後者のほうが小さいと判定されています。

"1.1.beta9" と "1.1.beta10" では、"beta9" と "beta10" の部分だけが違いますが、アルファベット部分と数字部分が分割され、数字部分は整数の大小比較になるため、後者のほうが大きいと判定されます。

特異メソッド

定義 説明
correct?(version) -> bool

version が正しいバージョンであれば真を返します。そうでなければ偽を返します。

create(input) -> Gem::Version | nil

Gem::Version のインスタンスを作成するためのファクトリメソッドです。

インスタンスメソッド

定義 説明
self <=> other -> Integer | nil

self と other を比較して、self が大きい時に 1 等しい時に 0、小さい時に -1 の整数を返します。

bump -> Gem::Version

最後の一桁を切り上げた新しい Gem::Version のインスタンスを返します。

eql?(other) -> bool

self と other の Gem::Version#version が等しいとき真を返します。そうでなければ偽を返します。

marshal_dump -> Array

完全なオブジェクトではなく、バージョン文字列のみダンプします。

marshal_load(array) -> String

ダンプされた情報をロードします。

prerelease? -> bool

self がプレリリースと思われる文字を含むバージョンかどうかを返します。

release -> Gem::Version

self をリリースバージョンにした Gem::Version オブジェクトを返します。

version -> String
to_s -> String

バージョン情報を文字列として返します。

version=(version)

self のバージョン情報を書き換えます。

継承したメソッド

! != __id__ instance_eval instance_exec method_missing singleton_method_added singleton_method_removed singleton_method_undefined < <= == > >= between? clamp !~ === =~ __send__ _dump class clone define_singleton_method display enum_for equal? extend freeze frozen? hash initialize initialize_copy inspect instance_of? instance_variable_defined? instance_variable_get instance_variable_set instance_variables is_a? itself method methods nil? object_id pretty_inspect pretty_print pretty_print_cycle pretty_print_inspect pretty_print_instance_variables private_methods protected_methods psych_to_yaml public_method public_methods public_send remove_instance_variable respond_to? respond_to_missing? singleton_class singleton_method singleton_methods taint tainted? tap to_a to_ary to_hash to_int to_io to_proc to_regexp to_str trust untaint untrust untrusted? yield_self .new .yaml_tag ::ARGF ::ARGV ::DATA ::ENV ::FALSE ::NIL ::RUBY_COPYRIGHT ::RUBY_DESCRIPTION ::RUBY_ENGINE ::RUBY_ENGINE_VERSION ::RUBY_PATCHLEVEL ::RUBY_PLATFORM ::RUBY_RELEASE_DATE ::RUBY_REVISION ::RUBY_VERSION ::SCRIPT_LINES__ ::STDERR ::STDIN ::STDOUT ::TOPLEVEL_BINDING ::TRUE