range_extd 0.3.0 → 0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: e414692d4b21325679b022e9b1364ea3272a639a
-  data.tar.gz: 633ff4d1cba4c73fc523f1d6b0ec0272fcbf755e
+SHA256:
+  metadata.gz: 9e1551349faa64451f2d3cb0d0105e0e36d031822fd6d614ff6c641be3ae6091
+  data.tar.gz: 9cfe5dce8e2e887bd8536c37e6e81e47566c477158cdecc5e4dba4ed48aed058
 SHA512:
-  metadata.gz: f4ad1eeccabb65b819180c506a50a7763ec97d0a944548bf3ee62ba5ba766841853ec2677aa4f256dcdd0a1e668cad377dd1911190afba3cb020c6408eeeca70
-  data.tar.gz: 8f63b3abfde62792334c3e013de34dfa0c4d53c2b5f917631f7ba63891ae5a8868041fd58701da8d47ac20912b4cc7abbf910129e0f3184da5cedbb0f3046298
+  metadata.gz: fed26ea14419c50417d319f54e1fc40d33e5fd95d92f2e19b110c6ebb001fb86581097de95c4551e1d50a4c4919e9c33ffef11a2c8837ffc03f3413cf6a091cf
+  data.tar.gz: e3cd288b44a7d42c9a8b8e947cb4bf030e4b906096bd779d304690708815e8eeabf916893ab334456a69a153504e73364f57e9a5167607b73d64f02f372fb5e4

data/.gitignore

@@ -0,0 +1,55 @@
+# See https://help.github.com/articles/ignoring-files for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile '~/.gitignore_global'
+
+# Ignore bundler config.
+/.bundle
+/vendor/bundle
+
+# Ignore all logfiles and tempfiles.
+/log/*
+/tmp/*
+!/log/.keep
+!/tmp/.keep
+
+.rbenv-version
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+/node_modules
+/yarn-error.log
+
+.byebug_history
+
+*.[oa]
+*.so
+*~
+*.nogem
+*nogem.*
+*.bak
+*.BAK
+*.backup
+*.org
+*.orig
+*.elc
+*.pyc
+\#*\#
+.\#*
+
+# Elastic Beanstalk Files
+.elasticbeanstalk/*
+!.elasticbeanstalk/*.cfg.yml
+!.elasticbeanstalk/*.global.yml
+
+# macOS
+.DS_Store
+
+# yard
+*.yardoc
+
+# Ruby Gem doc
+*.gem
+doc/*
+

data/ChangeLog

@@ -1,6 +1,19 @@
+-----
+(Version: 0.4)
+2019-10-30  Masa Sakano
+  * Many minor bug fixes (mostly suppressing Warnings) to catch up with Ruby 2.6.
+  * Because quite a few (boundary) behaviours have changed from previous versions a few years ago, such as the comparison between two INFINITY.
+  * Endless range not yet fully incorporated.
+
+-----
+(Version: 0.4.0)
+2014-05-10  Masa Saskano
+ * Added Range#equiv? and RangeExtd#equiv? methods.
+
 -----
 (Version: 0.3.0)
-2014-05-02  Masa Saskano
+2014-05-02  Masa Sakano
+
  * Added a String expression form of RangeExtd.new and RangeExtd.valid?(), modifying RangeExtd._get_init_args().
 
 -----

data/Makefile

@@ -0,0 +1,23 @@
+ALL	= 
+
+objs	= 
+
+.SUFFIXES:	.so .o .c .f
+
+#.o.so:
+#	${LD} ${LFLAGS} -o $@ $< ${LINK_LIB}
+
+all: ${ALL}
+
+
+.PHONY: clean test doc
+clean:
+	$(RM) bin/*~
+
+## You may need RUBYLIB=`pwd`/lib:$RUBYLIB
+test:
+	rake test
+
+doc:
+	yard doc; [[ -x ".github" && ( "README.ja.rdoc" -nt ".github/README.md" ) ]] && ( ruby -r rdoc -e 'puts RDoc::Markup::ToMarkdown.new.convert ARGF.read' < README.ja.rdoc > .github/README.md ; echo ".github/README.md is updated." ) || exit 0
+

data/News

@@ -1,3 +1,7 @@
+-----
+(Version: 0.4.0) 2014-05-10
+ * Added Range#equiv? method.
+
 -----
 (Version: 0.3.0) 2014-05-02
  * Fixed a bug that RangeExtd used to accept (nil...nil,true).  Not any more.

data/README.en.rdoc

@@ -22,6 +22,7 @@ For example, <tt>(3...3).valid?</tt>  returns false, because the element 3 is
 inclusive for the begin boundary, yet exclusive for the end boundary,
 which are contradictory to each other.  With this RangeExtd class,
 it is expressed as a valid range,
+
 * RangeExtd.new(3, 3, true,  true)   # => an empty range
 * RangeExtd.new(3, 3, false, false)  # => a single-point range (3..3)
 
@@ -31,12 +32,15 @@ so it is completely compatible with the standard Ruby.
 To express open-ended ranges is simple; you just use either of
 the two (negative and positive, or former and later) constants
 defined in the class {RangeExtd::Infinity}
+
 * RangeExtd::Infinity::NEGATIVE
 * RangeExtd::Infinity::POSITIVE
 
 They are basically the object that generalised <tt>Float::INFINITY</tt> to
 any Comparable object.  For example,
+
    ("a"..RangeExtd::Infinity::POSITIVE).each
+
 gives an infinite iterator with <tt>String#succ</tt>, starting from "a"
 (therefore, make sure to code so it breaks the iterator at one stage!).
 
@@ -64,10 +68,19 @@ I hope you find it to be useful.
 
 ==== NOTE: Relationship with Rangesmaller
 
-This package supercedes the obsolete Rangesmaller package and class,
+This package supercedes the obsolete {Rangesmaller}[https://rubygems.org/gems/rangesmaller] package and class,
 with the added open-ended feature, and a different interface in
 creating a new instance.
-{https://rubygems.org/gems/rangesmaller}
+https://rubygems.org/gems/rangesmaller
+
+==== NOTE: Relationship with Rangeary
+
+The class to handle multiple Ranges with objects of the same class
+(most typically Float),
+{Rangeary}[https://rubygems.org/gems/rangeary] uses this library to
+fullest, because the concept of potentially open-ended Range ato both
+begin and end is essential to realise Rangeary.
+https://rubygems.org/gems/rangeary
 
 
 == Install
@@ -75,19 +88,28 @@ creating a new instance.
   gem install range_extd
 
 Two files
+
   range_extd/range_extd.rb
   range_extd/infinity/infinity.rb
+
 should be installed in one of your <tt>$LOAD_PATH</tt> 
 
 Alternatively get it from
+
   http://rubygems.org/gems/range_extd
 
 Then all you need to do is
+
   require 'range_extd/range_extd'
+
 or, possibly as follows, if you manually install it
+
   require 'range_extd'
+
 in your Ruby script (or irb).  The other file
+
   range_extd/infinity/infinity.rb
+
 is called (required) from it automatically.
 
 Have fun!
@@ -126,7 +148,7 @@ defined by a user (see {RangeExtd.middle_strings=}() for detail), and is arguabl
 the most visibly recognisable way for any range with <tt>exclude_begin=true</tt>.
 
 <tt>RangeExtd.new()</tt> is the same thing.
-For more detail and examples, see {RangeExtd.new}.
+For more detail and examples, see {RangeExtd.initialize}.
 
 
 === Slightly more advanced uses
@@ -147,6 +169,7 @@ For more detail and examples, see {RangeExtd.new}.
    RangeExtd(?a, ?e, true, true).empty? # => false
    RangeExtd::NONE.is_none?             # => true
    RangeExtd::ALL.is_all?               # => true
+   (3...7).equiv?(3..6)    # => true
 
 All the methods that are in the built-in Range can be used.
 
@@ -173,7 +196,9 @@ They are the objects that generalise the concept of
 to any Comparable objects.  The methods <tt><=></tt> and <tt>succ</tt>  are defined.
 
 You can use them the same as other objects, such as,
+
   ("k"..RangeExtd::Infinity::POSITIVE)
+
 However as they do not have any other methods,
 the use out of Range-type class is probably meaningless.
 
@@ -216,9 +241,11 @@ See the document of each method for detail (some are defined only in
 * <tt>null?</tt> 
 * <tt>is_none?</tt> 
 * <tt>is_all?</tt> 
+* <tt>equiv?</tt> 
 
 There are three class methods, the first of which is equivalent 
 to the instance method <tt>valid?</tt>:
+
 * <tt>RangeExtd.valid?</tt> 
 * <tt>RangeExtd.middle_strings=(ary)</tt> 
 * <tt>RangeExtd.middle_strings</tt> 
@@ -281,20 +308,28 @@ existing code in principle.
 
 == Known bugs
 
-* <tt>hash()</tt> method does not always guarantee to return a unique
-  and exclusive number for the equal RangeExtd object, though such an
-  exception is extremely unlikely to happen in reality.
-
-Note this library does not work in Ruby 1.8 or earlier.
-For Ruby 1.9.3 it is probably all right, however I have never tested
-it.
+* As of Ruby 2.6, {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
+  is introduced.  As a result, Range#end sometimes raises RangeError.
+  However, this library does not yet take it into account, and it may
+  raises Exception when encountering an endless Range.
+* Note this library does not work in Ruby 1.8 or earlier.
+  For Ruby 1.9.3 it is probably all right, though I have never tested it.
+* Some unusual (rare) boundary conditions are found to vary from
+  version to version in Ruby, such as a comparison between
+  Float::INFINITY-s.  Though the test scripts are pretty extensive,
+  they have not been performed over many different versions of Ruby.
+  In some versions, some features may not work well, although such
+  occasions should be very rare.
+* {RangeExtd#hash} method does not theoretically guarantee to return a unique
+  number for a {RangeExtd} object, though to encounter a hash number that is
+  used elsewhere is extremely unlikely to happen in reality.
 
 Extensive tests have been performed, as included in the package.
 
 
 == ToDo
 
-Nothing planned.
+* Handle the Ruby-2.6 new feature {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1].
 
 
 == Final notes
@@ -334,3 +369,355 @@ License:: MIT.
 Warranty:: No warranty whatsoever.
 Versions:: The versions of this package follow Semantic Versioning (2.0.0) http://semver.org/
 
+
+
+= RangeExtd - 拡張Rangeクラス - exclude_begin と無限大に開いた範囲と
+
+このパッケージは、Range を拡張した RangeExtd クラスを定義しています。
+以下の特徴を持ちます。
+
+ 1. メソッド exclude_begin? の導入 (レンジの始点を除外できる),
+ 2. (無限大に)開いたレンジ
+ 3. NONE (空レンジ) と ALL (全範囲レンジ)定数の導入
+ 4. 初めて自己論理的に完結したレンジ構造の達成
+ 5. 組込Rangeとの完全後方互換性
+
+組込Rangeにある exclude_end に加えて、exclude_beginを導入したこと、及
+び無限大へ開いた範囲を許可したことで、一次元上の範囲の論理的完全性を実
+現しました。
+
+これにより、レンジの有効性を厳密に定義しています。それに従って、数個の
+メソッドを Range及び(自然に)そのサブクラスに追加しました。なかでも特徴的なのが、
+{Range#valid?} と {Range#empty?} です。
+
+たとえば、<tt>(3...3).valid?</tt> は偽を返します。要素の 3 が、始点と
+しては含まれているのに対し、終点としては除外されていて、これは相互に矛
+盾しているためです。ここで導入する RangeExtdクラスにおいては、以下のよ
+うにこれが有効なレンジとして定義できます。
+
+* RangeExtd.new(3, 3, true,  true)   # => 空レンジ
+* RangeExtd.new(3, 3, false, false)  # => 一点レンジ (3..3)
+
+しかしながら、組込Rangeの範囲内に収まっている限り、何も変わっていませ
+ん。つまり、標準の Rubyとの完全な後方互換性を実現しています。
+
+無限に開いたレンジを表すのは簡単です。単に {RangeExtd::Infinity}クラスで
+定義されている二つの定数(無限大または無現小、あるいは無限前と無限後)の
+いずれかを用います。
+
+* RangeExtd::Infinity::NEGATIVE
+* RangeExtd::Infinity::POSITIVE
+
+これらは基本的に <tt>Float::INFINITY</tt> を全ての Comparableであるオ
+ブジェクトに一般化したものです。たとえば、
+
+   ("a"..RangeExtd::Infinity::POSITIVE).each
+
+は、"a"から始まる <tt>String#succ</tt> を使った無限のイテレーターを与えます
+(だから、どこかで必ず breakするようにコードを書きましょう!)。
+
+組込 Rangeは大変有用なクラスであり、Rubyユーザーに容易なプログラミングを可能にす
+るツールでした。しかし、始点を除外することができないのが玉に瑕でありました。
+
+ただし、それにはれっきとした理由があることは分かります。Rubyの Rangeは、Numeric
+(厳密にはその実数を表現したもの)だけに限ったものではありません。 <tt>succ()</tt> メソッ
+ドを持つオブジェクトによる Rangeは極めて有用です。一方、<tt>succ()</tt> の逆に相
+当するメソッドは一般的には定義されていません。そういう意味で、Rangeは本質的に非
+対称です。加えて、よく使われる Rangeオブジェクトのうちあるもの(たとえば Float)は
+連続的なのに対し、そうでないものも普通です(たとえば Integer や String)。この状況
+が厳密な定義をする時の混乱に拍車をかけています。
+
+ここで始点を除外可能としたことは、そういう意味で、道筋が100パーセント明らかなも
+のではありませんでした。ここで私が採用した RangeExtdクラスの定義は、おそらく、考え
+られる唯一のものではないでしょう。とはいえ、個人的には満足のいくものに仕上がりま
+したし、このレンジという枠内での論理的完全性をうまく達成できたと思います。
+
+このクラスが少なからぬ人に有用なものであることを願ってここにリリースします。
+
+
+==== 注: Rangesmallerとの関係
+
+このパッケージは、(今やサポートされていない) {Rangesmaller}[https://rubygems.org/gems/rangesmaller] パッケージ及びクラスを
+後継するものです。同クラスの機能に、無限に開いた範囲を許す機能が加わり、また、オ
+ブジェクト生成時のインターフェースが変更されています。
+https://rubygems.org/gems/rangesmaller
+
+==== 注: Rangearyとの関係
+
+同クラス(典型的にはFloat)のオブジェクトからなる複数のRangeを扱うクラス
+{Rangeary}[https://rubygems.org/gems/rangeary] は、本ライブラリを使い
+切っています。Rangeを実現するためには、始端と終端との両方で開いた可能
+性があるRangeを扱うことが必須だからです。
+https://rubygems.org/gems/rangeary
+
+== インストール
+
+  gem install range_extd
+
+により、ファイルが 2個、
+
+  range_extd/range_extd.rb
+  range_extd/infinity/infinity.rb
+
+<tt>$LOAD_PATH</tt> の一カ所にインストールされるはずです。
+
+あるいは、パッケージを以下から入手できます。
+
+  http://rubygems.org/gems/range_extd
+
+後は、Ruby のコード(又は irb)から
+
+  require 'range_extd/range_extd'
+
+とするだけです。もしくは、特に手でインストールした場合は、
+
+  require 'range_extd'
+
+とする必要があるかも知れません。もう一方のファイル
+
+  range_extd/infinity/infinity.rb
+
+は、自動的に読み込まれます。
+
+お楽しみあれ!
+
+
+== 単純な使用例
+
+=== RangeExtd インスタンスを作成する方法
+
+以下に幾つかの基本的な使用例を列挙します。
+
+   r = RangeExtd(?a...?d, true)  # => a<...d
+   r.exclude_begin?              # => true 
+   r.to_a                        # => ["b", "c"]
+   RangeExtd(1...2)            == (1...2)          # => true
+   RangeExtd(1, 2, false, true)== (1...2)          # => true
+   RangeExtd(1, 1, false, false)==(1..1)           # => true
+   RangeExtd(1, 1, true, true) == RangeExtd::NONE  # => true
+   RangeExtd(1, 1, false, true)  # => ArgumentError
+   (RangeExtd::Infinity::NEGATIVE..RangeExtd::Infinity::POSITIVE) \
+    == RangeExtd::ALL  # => true
+
+インスタンスを作成するのには、三通りあります。
+
+   RangeExtd(range, [exclude_begin=false, [exclude_end=false]], opts)
+   RangeExtd(obj_begin, obj_end, [exclude_begin=false, [exclude_end=false]], opts)
+   RangeExtd(obj_begin, string_form, obj_end, [exclude_begin=false, [exclude_end=false]], opts)
+
+大括弧の中の二つのパラメーターが、それぞれ始点と終点とを除外する(true)、または含む
+(false)を指示します。もし、その二つのパラメーターが最初のパラメーターのレンジ
+(Range or RangeExtd) と矛盾する場合は、ここで与えた二つのパラメーターが優先され
+ます。同じパラメーターをオプションHash
+(<tt>:exclude_begin</tt> と <tt>:exclude_end</tt>)で指定することもできて、
+もし指定されればそれらが最高の優先度を持ちます。
+第三の方法の <tt>string_form</tt> とは、".." や "<..."のことで、ユーザー定義
+も可能です(詳しくは {RangeExtd.middle_strings=}() を参照のこと)。これが、
+視覚的には最もわかりやすい方法かも知れません。
+
+<tt>RangeExtd.new()</tt> も上と同意味です。
+さらなる解説及び例は、{RangeExtd.initialize}を参照して下さい。
+
+
+=== 少し上級編
+
+   (1..RangeExtd::Infinity::POSITIVE).each do |i|
+     print i
+     break if i >= 9
+   end    # => self ( "123456789" => STDOUT )
+   (nil..nil).valid?  # => false
+   (1...1).valid?     # => false
+   (1...1).null?      # => true
+   RangeExtd.valid?(1...1)              # => false
+   RangeExtd(1, 1, true, true).valid?   # => true
+   RangeExtd(1, 1, true, true).empty?   # => true
+   RangeExtd(?a, ?b, true, true).to_a?  # => []
+   RangeExtd(?a, ?b, true, true).empty? # => true
+   RangeExtd(?a, ?e, true, true).to_a?  # => ["b", "c", "d"]
+   RangeExtd(?a, ?e, true, true).empty? # => false
+   RangeExtd::NONE.is_none?             # => true
+   RangeExtd::ALL.is_all?               # => true
+   (3...7).equiv?(3..6)    # => true
+
+組込Rangeに含まれる全てのメソッドが使用可能です。
+
+
+== 詳説
+
+ファイル range_extd.rb が読まれた段階で、次の二つのクラスが定義されます。
+
+* RangeExtd
+* RangeExtd::Infinity
+
+加えて、Range クラスに数個のメソッドが追加また改訂されます。Rangeクラスに加えら
+れる改変は、全て後方互換性を保っています。
+
+=== RangeExtd::Infinity クラス
+
+{RangeExtd::Infinity} クラスは、基本、定数二つのみを保持するものです。
+
+* RangeExtd::Infinity::NEGATIVE
+* RangeExtd::Infinity::POSITIVE
+
+これらは、 <tt>Float::INFINITY</tt> を全ての Comparable なオブジェクトに一般化し
+たものです。メソッド <tt><=></tt> と <tt>succ</tt> が定義されています。
+
+これらは、他のオブジェクトと同様に普通に使用可能です。たとえば、
+  ("k"..RangeExtd::Infinity::POSITIVE)
+とはいえ、他には何もメソッドを持っていないため、 Range型のクラスの中以外での使用
+はおそらく意味がないでしょう。
+
+なお、Numericのオブジェクトに対しては、原則として <tt>Float::INFINITY</tt> の方
+を使って下さい。
+
+ユーザー定義のどの Comparable なクラスに属するどのオブジェクトも、これら二定数と
+可換的に比較可能です。その際、同クラスに置ける比較メソッドがマナー良く書かれてあ
+る、という前提で。
+
+さらに詳しくは、マニュアルを参照して下さい(YARD　または RDoc形式で書かれた文書が
+コード内部に埋込まれていますし、それが RubyGemsのウェブサイトでも閲覧できます。
+
+
+=== RangeExtd クラス
+
+RangeExtd のインスタンスは、 Rangeと同じくイミュータブルです。だから、一度インス
+タンスが生成されると、変化しません。
+
+インスタンスの生成方法は上述の通りです(「使用例」の章)。レンジとして"valid"(後述)と見
+なされないインスタンスを生成しようとすると、例外(<tt>ArgumentError</tt>)が発生し、
+失敗します。
+
+このクラスには、二つの定数が定義されています。
+
+* RangeExtd::NONE
+* RangeExtd::ALL
+
+前者は、空レンジを表し、後者は全てを含むレンジ、すなわち正負両方向に開いたレンジを表します。
+
+{Range}クラスの通常のメソッド全てに加え、以下が {RangeExtd} と {Range}クラス両方に加え
+られています。詳細は、各メソッドのマニュアルを参照下さい(注: 幾つかのメソッドは
+{Range}クラスのみで定義されていて、 {RangeExtd} はそれを継承しています)。
+
+* <tt>exclude_begin?</tt>  ({Range}クラスでは未定義)
+* <tt>valid?</tt> 
+* <tt>empty?</tt> 
+* <tt>null?</tt> 
+* <tt>is_none?</tt> 
+* <tt>is_all?</tt> 
+* <tt>equiv?</tt> 
+
+クラスメソッドが三つあります。一番上のものは、
+インスタンスメソッドの <tt>valid?</tt> に等価です。
+
+* <tt>RangeExtd.valid?</tt> 
+* <tt>RangeExtd.middle_strings=(ary)</tt> 
+* <tt>RangeExtd.middle_strings</tt> 
+
+何がレンジとして有効 (<tt>#valid?</tt> => true) かの定義は以下です。
+
+1. 始点と終点とが互いに Comparable であり、かつその比較結果に矛盾がないこと。
+   この唯一の例外は {RangeExtd::NONE} で、これは valid です。
+   たとえば、<tt>(nil..nil)</tt> は valid では「ありません」(参考までに、この例は
+   Ruby 1.8 では例外を生じていました)。
+2. 始点は終点と等しい(<tt>==</tt>)か小さくなければなりません。すなわし、
+   <tt>(begin <=> end)</tt> は、-1 または 0 を返すこと。
+3. もし始点と終点とが等しい時、すなわち <tt>(begin <=> end) == 0</tt>ならば、
+   端を除外するかどうかのフラグは両端で一致していなければなりません。
+   すなわち、もし始点が除外ならば、終点も除外されていなくてはならず、逆も真です。
+   その一例として、 <tt>(1...1)</tt> は、"valid" では「ありません」。なぜならば
+   組込レンジでは、始点を常に含むからです。
+
+さらなる詳細は {RangeExtd.valid?} と {Range#valid?} のマニュアルを
+参照して下さい。
+
+何がレンジとして空(<tt>#empty?</tt> => true)かの定義は以下の通りです。
+
+1. レンジは、valid であること: <tt>valid?</tt> => true
+2. もしレンジの要素が離散的であれば、すなわち始点の要素がメソッド <tt>succ</tt>
+   を持っていれば、レンジ内部に要素が一つも無いことが条件(当然、始点のフラグ
+   は除外になっていなければなりません): <tt>to_a.empty?</tt> => true
+3. もしレンジが連続的であれば、すなわち始点の要素がメソッド <tt>succ</tt> を持っ
+   ていなければ、始点と終点とが等しく (<tt>(begin <=> end)</tt> => 0)、かつ両端
+   のフラグが除外になっていること: <tt>(exclude_begin? && exclude_end?)</tt> => true.
+
+なお、始点と終点とが等しい一方でその除外フラグが一致しない場合は、前節で述べたよ
+うに "valid"ではありません。組込レンジは、始点除外フラグが常に偽(<tt>false</tt>)で
+す。そのため、組込Rangeのオブジェクトで、<tt>empty?</tt> が真(<tt>true</tt>)にな
+ることはありません。
+
+さらなる詳細は {Range#empty?} のマニュアルを
+参照して下さい。
+
+
+最後、 {Range#null?} は、「<tt>empty?</tt> または "valid"でない」ことに等
+価です。従って、 RangeExtd オブジェクトにとっては、<tt>null?</tt> は
+<tt>empty?</tt> に等価です。
+
+RangeExtd と別の RangeExtd または Rangeの比較 (<tt><=></tt>) においては、これら
+の定義が考慮されます。そのうちの幾つかは、上の「使用例」の項に示されています。
+さらなる詳細は {Range#==}、{RangeExtd#==} および
+<tt>#eql?</tt> のマニュアルを参照して下さい。
+
+なお、処理が Rangeオブジェクト内部で閉じている限り、その振舞いは標準 Rubyと同一
+で、互換性を保っています。したがって、このライブラリを読込むことで既存のコードに
+影響を与えることは原理的にないはずです。
+
+
+== 既知のバグ
+
+
+* Ruby 2.6 では、後ろに無限に開いたRange({Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1])
+  が導入されました。本ライブラリでは、まだそれには対応していません。
+  したがって、Endless Rangeを本クラスに適用した場合、問題が起きるでしょう。
+* このライブラリは Ruby 1.8 およびそれ以前のバージョンでは動作しません。
+  Ruby 1.9.3 ではおそらく大丈夫でしょうが、私は試したことがありません。
+* いくつかの極めて稀な境界条件に於ける挙動は、Rubyのバージョンごとにあ
+  る程度変化しています。例えば、Float::INFINITY 同士の比較などの挙動が
+  異なります。同梱のテストスクリプトはかなり網羅的ではあるものの、Ruby
+  の多数のバージョンでテストはしておりません。したがって、バージョンに
+ よっては、(極めて稀でしょうが)問題が発生する可能性が否定できません。
+* {RangeExtd#hash} メソッドは、ある RangeExtdオブジェに対して常に唯一で排他的な
+  数値を返すことが理論保証はされていません。ただし、現実的にそれが破られることは、まず
+  ありません。
+
+パッケージに含まれている通り、網羅的なテストが実行されています。
+
+
+== 開発項目
+
+* Ruby 2.6の後ろに無限に開いたRange({Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1])に対応する。
+
+
+== 終わりに
+
+RangeExtd内部に閉じた(Rangeでなく)挙動、たとえば RangeExtd同士の比較などは、
+全てユーザーにとって自然なもののはずです(と期待します?)。少なくとも、RangeExtdに
+よってレンジの論理構造が完結した今、これはよく定義されかつ自己矛盾が無いものと言
+えましょう。ただ、端の無限に開いた、あるいは始点が除外されたレンジの挙動には、
+一瞬ぎょっとするものが無くはないかも知れないことに注意して下さい。たとえば、
+片端が小さい方向に無限に開いて離散的な要素を持つレンジに対してメソッド
+<tt>member?(obj)</tt> を実行すると、 <tt>nil</tt>が返ります。これは、無限(小)に
+は実質的な意味を持つ <tt>succ()</tt> メソッドが定義されていないためで、したがっ
+て与えられた objがレンジの要素(member)かどうかを調べることが、一般論としては理論
+的に不可能だからです。これはちょっと不思議に思うかも知れませんが、それはつまり定
+命の私たちには無限という概念を計り知るのが容易でない、というだけの話でしょう!
+
+一方、RangeExtd と Range との比較は、それ以上に驚くことがあるかも知れません。こ
+れは、組込Rangeクラスで許容されているレンジの一部は、始点を除外することを認めた
+枠組の中では、前述のように最早有効(valid)と見なされないからです。この枠組に慣れるに
+したがって、それらが自然だと思えるようになればいいのですが。保証しますが、一旦こ
+れに慣れてしまえば、論理的不完全さ極まる混沌とした世界、つまりは Rangeの現在の挙
+動には二度と戻りたくなくなることでしょう!
+
+お楽しみ下さい。
+
+
+== その他
+
+== 著作権他情報
+
+著者::  Masa Sakano < imagine a_t sakano dot co dot uk >
+利用許諾条項:: MIT.
+保証:: 一切無し。
+バージョン:: Semantic Versioning (2.0.0) http://semver.org/
+