range_extd 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dae65a7801b819ebc7527acbbf1080c33b39f30b
-  data.tar.gz: f242186b0e029594148cd3f09fd460fc0e8143ae
+  metadata.gz: e414692d4b21325679b022e9b1364ea3272a639a
+  data.tar.gz: 633ff4d1cba4c73fc523f1d6b0ec0272fcbf755e
 SHA512:
-  metadata.gz: 7520c16da3bbfe5e13cb4c6d18553c412b6e34431704f4ba2f591549af3e712d285e821567cfa8f9bd597c09dcf4335a02d330085a9163adeb6b8ee4aef86025
-  data.tar.gz: 10febe606e27681b7f7e4fdb43589f3127ba1a5cd976baa97b8ba09da506c63659b6c81d05af2fe76dec88a7df233fd99cbbcec0b48e05f177cb6a4978e90a3f
+  metadata.gz: f4ad1eeccabb65b819180c506a50a7763ec97d0a944548bf3ee62ba5ba766841853ec2677aa4f256dcdd0a1e668cad377dd1911190afba3cb020c6408eeeca70
+  data.tar.gz: 8f63b3abfde62792334c3e013de34dfa0c4d53c2b5f917631f7ba63891ae5a8868041fd58701da8d47ac20912b4cc7abbf910129e0f3184da5cedbb0f3046298

data/ChangeLog

@@ -1,11 +1,23 @@
+-----
+(Version: 0.3.0)
+2014-05-02  Masa Saskano
+ * Added a String expression form of RangeExtd.new and RangeExtd.valid?(), modifying RangeExtd._get_init_args().
+
+-----
+2014-05-01  Masa Sakano
+
+ * Fixed a bug that RangeExtd used to accept (nil...nil,true).  Not any more.
+ * 	Added two class methods in RangeExtd: middle_strings=() and middle_strings().
+
 -----
 (Version: 0.2.0)
-2014-04-29  Masa Saskano
+2014-04-29  Masa Sakano
+
  * Changed the name of a constant from RangeExtd::EVERYTHING to RangeExtd::ALL.
-	Now accepts optional arguments in RangeExtd.new().
-	Bug fix in RangeExtd#size when the begin is Float/Rational.
-	Updated the embeded document in infinity.rb, mentioning about Time and Date classes.
-	Added a text file News at the top directory.
+ * 	Now accepts optional arguments in RangeExtd.new().
+ * 	Bug fix in RangeExtd#size when the begin is Float/Rational.
+ * 	Updated the embeded document in infinity.rb, mentioning about Time and Date classes.
+ * 	Added a text file News at the top directory.
 
 -----
 (Version: 0.1.1)

data/News

@@ -1,3 +1,9 @@
+-----
+(Version: 0.3.0) 2014-05-02
+ * Fixed a bug that RangeExtd used to accept (nil...nil,true).  Not any more.
+ * Added two class methods in RangeExtd: middle_strings=() and middle_strings().
+ * Added a String expression form of RangeExtd.new().
+
 -----
 (Version: 0.2.0) 2014-04-29
  * Changed the name of a constant from RangeExtd::EVERYTHING to RangeExtd::ALL.

data/README.en.rdoc

@@ -110,17 +110,23 @@ Here are some simple examples.
    (RangeExtd::Infinity::NEGATIVE..RangeExtd::Infinity::POSITIVE) \
     == RangeExtd::ALL  # => true
 
-Basically, there are two forms:
+Basically, there are three forms:
 
    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)
 
 The two parameters in the brackets specify the respective boundary to be excluded if true,
 or included if false (Default).  If they contradict to the first
 parameter of the range (Range or RangeExtd), those latter two parameters are used.
 Also, you can specify the same parameters as the options <tt>:exclude_begin</tt>
 and <tt>:exclude_end</tt>, which have the highest priority, if specified.
+The <tt>string_form</tt> in the third form is like ".." and "<...", which can be
+defined by a user (see {RangeExtd.middle_strings=}() for detail), and is arguably
+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}.
 
 
 === Slightly more advanced uses
@@ -199,21 +205,23 @@ The former represents the empty range and the latter does the range
 covers everything, namely open-ended for the both negative and
 positive directions.
 
-In addition to all the standard methods of Range, the following
-methods are added to both RangeExtd and Range classes.
+In addition to all the standard methods of {Range}, the following
+methods are added to both {RangeExtd} and {Range} classes.
 See the document of each method for detail (some are defined only in
-Range class, as RangeExtd inherits it).
+{Range} class, as {RangeExtd} inherits it).
 
-* <tt>exclude_begin?</tt> 
+* <tt>exclude_begin?</tt> (not defined in {Range} class)
 * <tt>valid?</tt> 
 * <tt>empty?</tt> 
 * <tt>null?</tt> 
 * <tt>is_none?</tt> 
 * <tt>is_all?</tt> 
 
-There is a class method, which is equivalent to the instance
-method <tt>valid?</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> 
 
 What is valid (<tt>#valid?</tt> => true) as a range is defined as follows.
 

data/README.ja.rdoc

@@ -110,17 +110,24 @@ Here are some simple examples.
    (RangeExtd::Infinity::NEGATIVE..RangeExtd::Infinity::POSITIVE) \
     == RangeExtd::ALL  # => true
 
-Basically, there are two forms:
+Basically, there are three forms:
 
    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)
 
 The two parameters in the brackets specify the respective boundary to be excluded if true,
 or included if false (Default).  If they contradict to the first
 parameter of the range (Range or RangeExtd), those latter two parameters are used.
 Also, you can specify the same parameters as the options <tt>:exclude_begin</tt>
 and <tt>:exclude_end</tt>, which have the highest priority, if specified.
+The <tt>string_form</tt> in the third form is like ".." and "<...", which can be
+defined by a user (see {RangeExtd.middle_strings=}() for detail), and is arguably
+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}.
+
 
 === Slightly more advanced uses
 
@@ -198,21 +205,23 @@ The former represents the empty range and the latter does the range
 covers everything, namely open-ended for the both negative and
 positive directions.
 
-In addition to all the standard methods of Range, the following
-methods are added to both RangeExtd and Range classes.
+In addition to all the standard methods of {Range}, the following
+methods are added to both {RangeExtd} and {Range} classes.
 See the document of each method for detail (some are defined only in
-Range class, as RangeExtd inherits it).
+{Range} class, as {RangeExtd} inherits it).
 
-* <tt>exclude_begin?</tt> 
+* <tt>exclude_begin?</tt> (not defined in {Range} class)
 * <tt>valid?</tt> 
 * <tt>empty?</tt> 
 * <tt>null?</tt> 
 * <tt>is_none?</tt> 
 * <tt>is_all?</tt> 
 
-There is a class method, which is equivalent to the instance
-method <tt>valid?</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> 
 
 What is valid (<tt>#valid?</tt> => true) as a range is defined as follows.
 
@@ -434,10 +443,11 @@ Versions:: The versions of this package follow Semantic Versioning (2.0.0) http:
    (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)を指示します。もし、その二つのパラメーターが最初のパラメーターのレンジ
@@ -445,7 +455,12 @@ Versions:: The versions of this package follow Semantic Versioning (2.0.0) http:
 ます。同じパラメーターをオプションHash
 (<tt>:exclude_begin</tt> と <tt>:exclude_end</tt>)で指定することもできて、
 もし指定されればそれらが最高の優先度を持ちます。
+第三の方法の <tt>string_form</tt> とは、".." や "<..."のことで、ユーザー定義
+も可能です(詳しくは {RangeExtd.middle_strings=}() を参照のこと)。これが、
+視覚的には最もわかりやすい方法かも知れません。
+
 <tt>RangeExtd.new()</tt> も上と同意味です。
+さらなる解説及び例は、{RangeExtd.new}を参照して下さい。
 
 
 === 少し上級編
@@ -522,19 +537,22 @@ RangeExtd のインスタンスは、 Rangeと同じくイミュータブルで
 
 前者は、空レンジを表し、後者は全てを含むレンジ、すなわち正負両方向に開いたレンジを表します。
 
-Rangeクラスの通常のメソッド全てに加え、以下が RangeExtd と Rangeクラス両方に加え
+{Range}クラスの通常のメソッド全てに加え、以下が {RangeExtd} と {Range}クラス両方に加え
 られています。詳細は、各メソッドのマニュアルを参照下さい(注: 幾つかのメソッドは
-Rangeクラスのみで定義されていて、 RangeExtd はそれを継承しています)。
+{Range}クラスのみで定義されていて、 {RangeExtd} はそれを継承しています)。
 
-* <tt>exclude_begin?</tt> 
+* <tt>exclude_begin?</tt>  ({Range}クラスでは未定義)
 * <tt>valid?</tt> 
 * <tt>empty?</tt> 
 * <tt>null?</tt> 
 * <tt>is_none?</tt> 
 * <tt>is_all?</tt> 
 
-インスタンスメソッドの <tt>valid?</tt> に等価なクラスメソッドも一つあります。
+クラスメソッドが三つあります。一番上のものは、
+インスタンスメソッドの <tt>valid?</tt> に等価です。
 * <tt>RangeExtd.valid?</tt> 
+* <tt>RangeExtd.middle_strings=(ary)</tt> 
+* <tt>RangeExtd.middle_strings</tt> 
 
 何がレンジとして有効 (<tt>#valid?</tt> => true) かの定義は以下です。
 

data/lib/range_extd/infinity/infinity.rb

@@ -75,7 +75,7 @@ class RangeExtd < Range
   # is immediately comparable with the {RangeExtd::Infinity} instances,
   #    YourComparable.new <=> RangeExtd::Infinity::POSITIVE    # => -1
   #    RangeExtd::Infinity::POSITIVE <=> YourComparable.new    # => 1
-  # except for the infinity inscances in YourComparable (see #{==}).
+  # except for the infinity inscances in YourComparable (see {#==}).
   #
   # See the document in {Object#<=>} in this code/package for detail.
   #
@@ -98,7 +98,7 @@ class RangeExtd < Range
   # {#===}, {#==}, {#<=>}, {#succ}, {#to_s}, {#inspect},
   # {#infinity?}, {#positive?} and {#negative?}.
   #
-  # Note that the unary operand {#-@} is not defined.
+  # Note that the unary operand [#-@] is not defined.
   #
   class Infinity
   

data/lib/range_extd/range_extd.rb

@@ -77,14 +77,26 @@ end
 #
 class RangeExtd < Range
 
+  @@middle_strings = []
+
   # @note The flag of exclude_begin|end can be given in the arguments in a couple of ways.
   #  If there is any duplication, those specified in the optional hash have the highest
   #  priority.  Then the two descrete Boolean parameters have the second.
-  #  If not, the values embeded in the {Range} or {RangeExtd} object
+  #  If not, the values embeded in the {Range} or {RangeExtd} object or the String form
   #  in the parameter are used.  In default, both of them are false.
   #
+  # @example 
+  #    RangeExtd(1...2)
+  #    RangeExtd(1..3, true)
+  #    RangeExtd(2..3, :exclude_begin => true)
+  #    RangeExtd(1, 4, false, true)
+  #    RangeExtd(1,'<...',5)
+  #    RangeExtd.middle_strings = :math
+  #    RangeExtd(2,'<x<=',5)
+  #    RangeExtd(RangeExtd::Infinity::NEGATIVE..RangeExtd::Infinity::POSITIVE)
+  #
   # @overload new(range, [exclude_begin=false, [exclude_end=false]], opts)
-  #   @param [Object] range Instance of Range or its subclasses, including RangeExtd
+  #   @param [Object] range Instance of {Range} or its subclasses, including {RangeExtd}
   #   @param exclude_begin [Boolean] If specified, this has the higher priority, or false in default.
   #   @param exclude_end [Boolean] If specified, this has the higher priority, or false in default.
   #   @option opts [Boolean] :exclude_begin If specified, this has the highest priority, or false in default.
@@ -98,8 +110,19 @@ class RangeExtd < Range
   #   @option opts [Boolean] :exclude_begin If specified, this has the higher priority, or false in default.
   #   @option opts [Boolean] :exclude_end If specified, this has the higher priority, or false in default.
   #
-  # Note no possible opts are defined at present.
-  # Any opts given as Hash are simply ignored.
+  # @overload new(obj_begin, string_form, obj_end, [exclude_begin=false, [exclude_end=false]], opts)
+  #   @param obj_begin [Object] Any object that is {Comparable} with end
+  #   @param string_form [Object] String form (without pre/postfix) of range expression set by {RangeExtd.middle_strings=}()
+  #   @param obj_end [Object] Any object that is Comparable with begin
+  #   @param exclude_begin [Boolean] If specified, this has the lower priority, or false in default.
+  #   @param exclude_end [Boolean] If specified, this has the lower priority, or false in default.
+  #   @option opts [Boolean] :exclude_begin If specified, this has the higher priority, or false in default.
+  #   @option opts [Boolean] :exclude_end If specified, this has the higher priority, or false in default.
+  #
+  # Note if you use the third form with "string_form" with the user-defined string
+  # (via {RangeExtd.middle_strings=}()), make 100 per cent sure
+  # of what you are doing.  If the string is ambiguous, the result may differ
+  # from what you thought you would get!  See {RangeExtd.middle_strings=}() for detail.
   #
   # @raise [ArgumentError] particularly if the range to be created is not {#valid?}.
   def initialize(*inar, **hsopt)	# **k expression from Ruby 1.9?
@@ -397,7 +420,7 @@ class RangeExtd < Range
   end	# def cover?(i)
 
 
-  # @raise [TypeError] If {#exclude_begin?} is true, and {#begin}() or {#rangepart} does not have a method of {#succ}, then even if no block is given, this method raises TypeError straightaway.
+  # @raise [TypeError] If {#exclude_begin?} is true, and {#begin}() or {#rangepart} does not have a method of [#succ], then even if no block is given, this method raises TypeError straightaway.
   # @return [RangeExtd] self
   # @return [Enumerator] if block is not given.
   #
@@ -425,10 +448,10 @@ class RangeExtd < Range
   end
 
 
-  # Like {Range#last}, if no argument is given, it behaves like {#begin()}, that is, it returns the initial value, regardless of {#exclude_begin?}.
+  # Like {Range#last}, if no argument is given, it behaves like {#begin}(), that is, it returns the initial value, regardless of {#exclude_begin?}.
   # However, if an argument is given (nb., acceptable since Ruby 1.9) when {#exclude_begin?} is true, it returns the array that starts from {#begin}().succ().
-  # @raise [TypeError] if the argument (Numeric) is given and if {#exclude_begin?} is true, yet if {#begin}().succ is not defined, or yet if {#none}?
-  # @param [Integer] Optional.  Must be non-negative.  Consult {Range#first} for detail.
+  # @raise [TypeError] if the argument (Numeric) is given and if {#exclude_begin?} is true, yet if {#begin}().succ is not defined, or yet if {#is_none?}
+  # @param rest [Integer] Optional.  Must be non-negative.  Consult {Range#first} for detail.
   # @return [Object] if no argument is given, equivalent to {#end}.
   # @return [Array] if an argument is given.
   def first(*rest)
@@ -693,7 +716,7 @@ class RangeExtd < Range
 
 
   # See {#each}.
-  # @raise [TypeError] If {#exclude_begin?} is true, and {#begin}() does not have the method {#succ}, then even if no block is given, this method raises TypeError straightaway.
+  # @raise [TypeError] If {#exclude_begin?} is true, and {#begin}() does not have the method [#succ], then even if no block is given, this method raises TypeError straightaway.
   # @return [RangeExtd] self
   # @return [Enumerator] if block is not given.
   #
@@ -722,14 +745,18 @@ class RangeExtd < Range
   end
 
 
+  ##################################################
+  # Class methods
+  ##################################################
+
   # Private class method to evaluate the arguments.
   def self._get_init_args(*inar, **hsopt)
-    nMin = 1; nMax = 4
+    nMin = 1; nMax = 5
     if inar.size < nMin || nMax < inar.size
       raise ArgumentError, "wrong number of arguments (#{inar.size} for #{nMin}..#{nMax})"
     end
 
-    hsFlag = { :prm1st => nil }
+    hsFlag = { :prm1st => nil, :excl_offset => nil }
     if    defined? inar[0].exclude_begin?
       hsFlag[:prm1st] = :rangeextd
     elsif defined? inar[0].exclude_end?
@@ -754,8 +781,8 @@ class RangeExtd < Range
         exclude_end   = inar[0].exclude_end?
       end
 
-      if inar.size > 3
-        nMin = 1; nMax = 3
+      nMin = 1; nMax = 3
+      if inar.size > nMax
         raise ArgumentError, "wrong number of arguments (#{inar.size} for #{nMin}..#{nMax})"
       end
 
@@ -764,19 +791,61 @@ class RangeExtd < Range
       # @rangepart = Range.new(inar[0].begin, inar[0].end, exclude_end)
 
     when :object
-      if inar.size > 2
-        exclude_begin = (true ^! inar[2])
-      else
-        exclude_begin = false
+      nMin = 2; nMax = 5
+      if inar.size < 2
+        raise ArgumentError, "wrong number of arguments (#{inar.size} for #{nMin}..#{nMax})"
       end
 
-      if inar.size > 3
-        exclude_end   = (true ^! inar[3])
+      # Default: assuming the form (obj_begin, obj_end, [excl_begin, [excl_end]])
+      beginend = [inar[0], inar[1]]
+      hsFlag[:excl_offset] = 0
+      exclude_begin = false
+      exclude_end   = false
+
+      # Now, checking if the form is the String one, and if so, process it.
+      arMid = @@middle_strings.map{|i| Regexp.quote(i)}	# See self.middle_strings=(ary) for description.
+      if inar.size > 2 && defined?(inar[1].=~)
+        begin
+          cmp = (inar[0] <=> inar[2]).abs
+        rescue
+          cmp = nil
+        end
+        if ((cmp == 0)||(cmp == 1)) && (inar[1] =~ /^(#{arMid[1]}|#{arMid[2]})#{arMid[3]}(#{arMid[4]}|#{arMid[5]})$/)
+          # The form is (obj_begin, midStr, obj_end, [excl_begin, [excl_end]])
+          # Hence all the default values are overwritten.
+          beginend = [inar[0], inar[2]]
+          hsFlag[:excl_offset] = 1
+          if $1 == @@middle_strings[1]
+            exclude_begin = false
+          else
+            exclude_begin = true
+          end
+          if $2 == @@middle_strings[4]
+            exclude_end   = true
+          else
+            exclude_end   = false
+          end
+        else
+          nMin = 2; nMax = 4
+          if inar.size > nMax
+            raise ArgumentError, "wrong number of arguments (#{inar.size} for #{nMin}..#{nMax})"
+          end
+        end
       else
-        exclude_end   = false
+        nMin = 2; nMax = 4
+        if inar.size > nMax
+          raise ArgumentError, "wrong number of arguments (#{inar.size} for #{nMin}..#{nMax})"
+        end
+      end
+
+      if inar.size > 2+hsFlag[:excl_offset]
+        exclude_begin = (true ^! inar[2+hsFlag[:excl_offset]])	# 3rd or 4th argument
+      end
+
+      if inar.size > 3+hsFlag[:excl_offset]
+        exclude_end   = (true ^! inar[3+hsFlag[:excl_offset]])	# 4th or 5th argument
       end
 
-      beginend = [inar[0], inar[1]]
       # arRet = [inar[0], inar[1], exclude_end, exclude_begin]
       # @rangepart = Range.new(inar[0], inar[1], exclude_end)
 
@@ -804,7 +873,7 @@ class RangeExtd < Range
   # This routine is also impremented as a method in {Range},
   # and accordingly its sub-classes.
   #
-  # This routine is called from {RangeExtd#new}, hence
+  # This routine is called from {RangeExtd.new}, hence
   # for any instance of {RangeExtd} class, its {#valid?} returns true.
   #
   # What is valid is defined as follows:
@@ -852,29 +921,24 @@ class RangeExtd < Range
   #  If not, the values embeded in the {Range} or {RangeExtd} object
   #  in the parameter are used.  In default, both of them are false.
   #
-  # @overload new(range, [exclude_begin=false, [exclude_end=false]], opts)
+  # @overload new(range, [exclude_begin=false, [exclude_end=false]])
   #   @param [Object] range Instance of Range or its subclasses, including RangeExtd
   #   @param exclude_begin [Boolean] If specified, this has the higher priority, or false in default.
   #   @param exclude_end [Boolean] If specified, this has the higher priority, or false in default.
-  #   @option opts [Boolean] :exclude_begin If specified, this has the highest priority, or false in default.
-  #   @option opts [Boolean] :exclude_end If specified, this has the highest priority, or false in default.
   #
-  # @overload new(obj_begin, obj_end, [exclude_begin=false, [exclude_end=false]], opts)
+  # @overload new(obj_begin, obj_end, [exclude_begin=false, [exclude_end=false]])
   #   @param obj_begin [Object] Any object that is {Comparable} with end
   #   @param obj_end [Object] Any object that is Comparable with begin
   #   @param exclude_begin [Boolean] If specified, this has the lower priority, or false in default.
   #   @param exclude_end [Boolean] If specified, this has the lower priority, or false in default.
-  #   @option opts [Boolean] :exclude_begin If specified, this has the higher priority, or false in default.
-  #   @option opts [Boolean] :exclude_end If specified, this has the higher priority, or false in default.
   #
-  def self.valid?(*inar, **hsopt)
+  def self.valid?(*inar)
     (vbeg, vend, exc_beg, exc_end) = _get_init_args(*inar)
 
-    if (vbeg.nil? && vend.nil? && exc_beg && exc_end)
-      return true	# equivalent to self.is_none?
-      # But this routine is called from new(), hence is_none?() is not used.
+    if defined?(inar[0].is_none?) && inar[0].is_none? && exc_beg && exc_end
+      return true
     end
-
+      
     begin
       t = (vbeg <=> vend)
       begin
@@ -912,11 +976,119 @@ class RangeExtd < Range
   end	# def valid?
 
 
+  # Set the class variable to be used in {RangeExtd#to_s} and {RangeExtd#inspect}
+  # to configure the format of their returned values.
+  #
+  # The parameters should be given as an Array with 7 elements of string
+  # in principle, which gives the characters for each index:
+  # 0. prefix
+  # 1. begin-inclusive
+  # 2. begin-exclusive
+  # 3. middle-string to bridge both ends
+  # 4. end-exclusive
+  # 5. end-inclusive
+  # 6. postfix
+  #
+  # If the elements [1] and [2], or [4] and [5] are equal,
+  # a warning is issued as some of {RangeExtd} in display will be indistinguishable.
+  # Note even if no warning is issued, that does not mean all the forms
+  # will be not ambiguous.  For example, if you specify
+  #   ['(', '', '.', '..', '.', '', ')']
+  # a string (3...7) can mean either exclusive {#begin} or {#end}.
+  # It is user's responsibility to make it right.
+  #
+  # The two most popular forms can be given as a Symbol instead of Array, that is,
+  #   :default  ( ['', '', '<', '..', '.', '', ''] )
+  #   :math     ( ['', '<=', '<', 'x', '<', '<=', ''] )
+  #
+  # @param ary [Array, Symbol]
+  # @return [Array, Symbol]
+  #
+  # @example
+  #    RangeExtd.middle_strings=:default  # Default
+  #    RangeExtd(2...6).to_s    # => "2...6"
+  #    RangeExtd(2,6,1).to_s    # => "2<..6"
+  #    RangeExtd.middle_strings=:math
+  #    RangeExtd(2...6).to_s    # => "2<=x<6"
+  #    RangeExtd(2,6,1).to_s    # => "2<x<=6"
+  #    RangeExtd.middle_strings=['[','(in)','(ex)',', ','(ex)','(in)',']']
+  #    RangeExtd(2...6).to_s    # => "[2(in), (ex)6]"
+  #    RangeExtd(2,6,1).to_s    # => "[2(ex), (in)6]"
+  #
+  def self.middle_strings=(ary)
+    case ary
+    when :default
+      @@middle_strings = ['', '', '<', '..', '.', '', '']
+    when :math
+      @@middle_strings = ['', '<=', '<', 'x', '<', '<=', '']
+    else
+      begin
+        if ary.size == 7
+          _dummy = 'a' + ary[6]
+          @@middle_strings = ary
+          if (ary[1] == ary[2]) || (ary[4] == ary[5])
+            warn "warning: some middle_strings are indistinguishable."
+          end
+        else
+          raise
+        end
+      rescue
+        raise ArgumentError, "invalid argument"
+      end
+    end
+  end
+
+  # See {RangExtd.middle_strings=}() for detail.
+  #
+  # @return [Array<String>]
+  def self.middle_strings()
+    @@middle_strings
+  end
+
+  self.middle_strings=:default	# Initialisation
+
+  ##################################################
   private
+  ##################################################
 
   # Core routine for {#inspect} and {#to_s}
   # @param [Symbol] method the method name.
   def re_inspect_core(method)
+    # 0. prefix
+    # 1. begin-inclusive
+    # 2. begin-exclusive
+    # 3. middle-string to bridge both ends
+    # 4. end-exclusive
+    # 5. end-inclusive
+    # 6. postfix
+
+    midStr = ''
+    if @exclude_begin
+      midStr += @@middle_strings[2]
+    else
+      midStr += @@middle_strings[1]
+    end
+    midStr += @@middle_strings[3]
+    if @exclude_end
+      midStr += @@middle_strings[4]
+    else
+      midStr += @@middle_strings[5]
+    end
+
+    if is_none?
+      strBegin = 'Null'		# Null<...Null
+      strEnd   = 'Null'
+    else
+      strBegin = self.begin.send(method)
+      strEnd   = self.end.send(method)
+    end
+
+    @@middle_strings[0] + strBegin + midStr + strEnd + @@middle_strings[6]
+  end	# def re_inspect_core(method)
+
+  # Core routine for {#inspect} and {#to_s}
+  # @param [Symbol] method the method name.
+  def re_inspect_core_orig(method)
     if @exclude_end
       midStr = "..."
     else
@@ -929,7 +1101,7 @@ class RangeExtd < Range
     else
       self.begin.send(method) + midStr + self.end.send(method)
     end
-  end	# def re_inspect_core(method)
+  end	# def re_inspect_core_orig(method)
 
 
   # Core routine for {#===} and {#eql?}
@@ -1028,9 +1200,9 @@ class Range
   # use them;
   #    (1...1).valid?   # => false
   # On the other hand, {RangeExtd} class does not accept or create
-  # any invalid range; for any {RangeExtd} object, {RangeExtd#valid}
+  # any invalid range; for any {RangeExtd} object, RangeExtd#valid?
   # returns true.  For example, there is no {RangeExtd} object
-  # that is expressed as (1...1) (See {#valid} for detail).
+  # that is expressed as (1...1) (See {#valid?} for detail).
   #
   # For that reason, when those non-valid Range objects are compared
   # with a {RangeExtd} object, the returned value may not be what
@@ -1039,7 +1211,7 @@ class Range
   # The former is an invalid range, while the latter is
   # a rigidly-defined empty range.
   #
-  # Consult {#valid} and {RangeExtd#==} for more detail.
+  # Consult {#valid?} and {RangeExtd#==} for more detail.
   def ==(r)
     equal_core(r, :==, :equal_prerangeextd?)
   end
@@ -1071,7 +1243,7 @@ class Range
   #    RangeExtd::ALL.valid?        # => true
   # 
   # @note By definition, all the {RangeExtd} instances are valid,
-  #  because {RangeExtd#new} checks the validity.
+  #  because {RangeExtd.new} checks the validity.
   def valid?
     RangeExtd.valid?(self)
   end	# def valid?
@@ -1085,17 +1257,17 @@ class Range
   #
   # 1. the range must be valid: {#valid?} => true
   # 2. if the range id discrete, that is, {#begin} has
-  #    {#succ} method, there must be no member within the range: 
+  #    [#succ] method, there must be no member within the range: 
   #    {#to_a}.empty? => true
   # 3. if the range is continuous, that is, {#begin} does not have
-  #    {#succ} method, {#begin} and {#end} must be equal
+  #    [#succ] method, {#begin} and {#end} must be equal
   #    (({#begin} <=> {#end}) => 0) and both the boundaries must
   #    be excluded: ({#exclude_begin?} && {#exclude_end?}) => true.
   #    Note that ranges with equal {#begin} and {#end} with
   #    inconsistent two exclude status are not valid, and the built-in
   #    Range always has the {#begin}-exclude status of false.
   #
-  # In these conditions, none of Range instance would return true in {#empty}.
+  # In these conditions, none of Range instance would return true in {#empty?}.
   #
   # @example
   #   (nil..nil).empty?  # => nil
@@ -1108,7 +1280,7 @@ class Range
   #   RangeExtd::NONE.empty?          # => true
   #
   # @note to check whether it is either empty or invalid, use {#null?}.
-  # See {#valid?} and {RangeExtd.valid}, too.
+  # See {#valid?} and {RangeExtd.valid?}, too.
   #
   # @return [Boolean, nil]
   def empty?
@@ -1222,7 +1394,7 @@ end	# class Range
 
 
 # Constant-form of {#RangeExtd}.
-# {#RangeExtd(*)} is equivalent to {#RangeExtd.new}.
+# #RangeExtd(*) is equivalent to {#RangeExtd.new}.
 #
 def RangeExtd(*rest, &b)
   RangeExtd.new(*rest, &b)

data/range_extd.gemspec

@@ -2,12 +2,12 @@
 
 Gem::Specification.new do |s|
   s.name = %q{range_extd}
-  s.version = "0.2.0"
+  s.version = "0.3.0"
   # s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   # s.executables << 'hola'
   # s.bindir = 'bin'
   s.authors = ["Masa Sakano"]
-  s.date = %q{2014-04-29}
+  s.date = %q{2014-05-02}
   s.summary = %q{RangeExtd - Extended Range class with exclude_begin and open-ends}
   s.description = %q{Package for a subclass of Range, RangeExtd and RangeExtd::Infinity.  The former defines a range that enables an exclusion of the begin boundary, in addition to the end boundary as in the built-in Range, and accepts open-ended ranges to infinity for either (or both) positive/negative direction.  The latter has the two constant objects, POSITIVE and NEGATIVE, and they are a generalised Infinity of Float::INFINITY to any Comparable objects.}
   # s.email = %q{abc@example.com}

data/test/test_range_extd.rb

@@ -281,6 +281,71 @@ return
       assert_equal(-@ib, j22.end)
     end
 
+    def test_new_middle_strings
+      aru = ['[','(in)','(ex)',', ','(ex)','(in)',']']
+      ark = [nil, :math, aru, :default]
+
+      ars = ['..', '<=x<=', aru[1]+aru[3]+aru[5]]; ars.push(ars[0])
+      ark.each_index do |i|
+        RangeExtd.middle_strings = ark[i] if ! ark[i].nil?
+        k11 = RangeExtd.new(@ib, ars[i], @ie)
+        assert !k11.exclude_begin?
+        assert !k11.exclude_end?
+        assert_equal @ib, k11.begin
+        assert_equal @ie, k11.end
+      end
+
+      ars = ['...', '<=x<', aru[1]+aru[3]+aru[4]]; ars.push(ars[0])
+      ark.each_index do |i|
+        RangeExtd.middle_strings = ark[i] if ! ark[i].nil?
+        k12 = RangeExtd.new(@ib, ars[i], @ie)
+        assert !k12.exclude_begin?
+        assert  k12.exclude_end?
+        assert_equal @ib, k12.begin
+        assert_equal @ie, k12.end
+      end
+
+      ars = ['<..', '<x<=', aru[2]+aru[3]+aru[5]]; ars.push(ars[0])
+      ark.each_index do |i|
+        RangeExtd.middle_strings = ark[i] if ! ark[i].nil?
+        k21 = RangeExtd.new(@ib, ars[i], @ie)
+        assert  k21.exclude_begin?
+        assert !k21.exclude_end?
+        assert_equal @ib, k21.begin
+        assert_equal @ie, k21.end
+      end
+
+      ars = ['<...', '<x<', aru[2]+aru[3]+aru[4]]; ars.push(ars[0])
+      ark.each_index do |i|
+        RangeExtd.middle_strings = ark[i] if ! ark[i].nil?
+        k22 = RangeExtd.new(@ib, ars[i], @ie)
+        assert  k22.exclude_begin?
+        assert  k22.exclude_end?
+        assert_equal @ib, k22.begin
+        assert_equal @ie, k22.end
+      end
+
+      l12 = RangeExtd.new(@ib, '..', @ie, true)
+      assert  l12.exclude_begin?
+      assert !l12.exclude_end?
+      assert_equal @ib, l12.begin
+      assert_equal @ie, l12.end
+
+      m22 = RangeExtd.new(-@ie, '..', -@ib, true, true)
+      assert  m22.exclude_begin?
+      assert  m22.exclude_end?
+      assert_equal(-@ie, m22.begin)
+      assert_equal(-@ib, m22.end)
+
+      assert_raises(ArgumentError){ RangeExtd.new(@ib, '....', @ie) }	# => the argument can not consist of a RangeExtd instance.
+      RangeExtd.middle_strings = :math
+      assert_raises(ArgumentError){ RangeExtd.new(@ib, '..', @ie) }	# => the argument can not consist of a RangeExtd instance.
+      RangeExtd.middle_strings = :default
+      assert_raises(ArgumentError){ RangeExtd.new(@ib, '..', @ie, T, nil, T) }	# => wrong number of arguments (6 for 1..5)
+      assert_raises(ArgumentError){ RangeExtd.new(@ib, @ie, T, nil, T) }	# => wrong number of arguments (5 for 2..4)
+      assert_raises(ArgumentError){ RangeExtd.new(@ib) }	# => wrong number of arguments (1 for 2..5)
+    end	# def test_new_middle_strings
+
     def test_new_const
       assert_equal @s22, RangeExtd(@r12, true)
     end
@@ -685,6 +750,7 @@ return
       assert_equal(2,   RangeExtd(0, ary.size).bsearch{|i| ary[i] >= 6})
       # http://www.ruby-doc.org/core-2.1.1/Range.html#method-i-bsearch
 
+      assert_equal(3,   RangeExtd(1..4).bsearch{   |i| ary[i] >=  9})	# (1..4).bsearch{|i| ary[i] >= 9} => 3
       assert_equal(nil, RangeExtd(3...4).bsearch{  |i| ary[i] >= 11})
       assert_equal(nil, RangeExtd(3.6...4).bsearch{|i| ary[i] >= 11})
       assert_equal(4,   RangeExtd(3...5).bsearch{  |i| ary[i] >= 11})
@@ -967,6 +1033,12 @@ return
     end
 
 
+    def test_RangeExtdClass_valid
+      assert !RangeExtd.valid?(nil, nil, 9,9)	# All 3 were true up to Version 0.1.0
+      assert !RangeExtd.valid?(nil...nil,9,9)
+      assert !RangeExtd.valid?(nil..nil, 9,9)
+    end	# def test_RangeExtdClass_valid
+
     def test_Range_valid
       assert  RangeExtd::NONE.valid?
       assert  RangeExtd::ALL.valid?
@@ -1171,7 +1243,7 @@ return
 
 
     # Tests of all the examples in the document.
-    def test_indocument
+    def test_in_document
       # RangeExtd#initialize
       r = RangeExtd(5...8, true) 
       assert  r.exclude_begin?  # => true 
@@ -1283,6 +1355,35 @@ return
       assert  RangeExtd.valid?(RangeExtd::Infinity::NEGATIVE..?d, true)  # => false
 	# Note the last example may change in the future release.
 
+      # RangeExtd.middle_strings=
+      arDef = ['', '', '<', '..', '.', '', '']
+      assert_equal arDef, RangeExtd.middle_strings
+      assert_equal "2...6",  RangeExtd(2...6).to_s
+      assert_equal "2<..6",  RangeExtd(2,6,1).to_s
+      assert_equal "2...6",  RangeExtd(2...6).inspect
+      assert_equal "2<..6",  RangeExtd(2,6,1).inspect
+      assert_equal 'a...c',  RangeExtd(?a...?c).to_s
+      assert_equal 'a<..c',  RangeExtd(?a,?c,1).to_s
+      assert_equal '"a"..."c"',  RangeExtd(?a...?c).inspect
+      assert_equal '"a"<.."c"',  RangeExtd(?a,?c,1).inspect
+
+      RangeExtd.middle_strings=:math
+      assert_equal ['', '<=', '<', 'x', '<', '<=', ''], RangeExtd.middle_strings
+      assert_equal "2<=x<6", RangeExtd(2...6).to_s
+      assert_equal "2<x<=6", RangeExtd(2,6,1).to_s
+      ar=['[','(in)','(ex)',', ','(ex)','(in)',']']
+
+      RangeExtd.middle_strings=ar
+      assert_equal ar, RangeExtd.middle_strings
+      assert_equal "[2(in), (ex)6]", RangeExtd(2...6).to_s
+      assert_equal "[2(ex), (in)6]", RangeExtd(2,6,1).to_s
+
+      RangeExtd.middle_strings=:default  # Default
+      assert_equal arDef, RangeExtd.middle_strings
+      assert_equal ['', '', '<', '..', '.', '', ''], RangeExtd.middle_strings
+      assert_equal "2...6",  RangeExtd(2...6).to_s
+      assert_equal "2<..6",  RangeExtd(2,6,1).to_s
+
       # Range.==
       assert !(1...1).valid?
       assert !(nil...nil).valid?
@@ -1313,7 +1414,7 @@ return
       assert_equal   1, (RangeExtd::Infinity::POSITIVE <=> ?z)
       assert_equal nil, (50 <=> RangeExtd::Infinity::POSITIVE)
       assert_equal   1, (RangeExtd::Infinity::POSITIVE <=> 50)
-    end
+    end	# def test_in_document
 
     # def test_RangeExtd_special
     #   # Positive Infinity (== 'z')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: range_extd
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Masa Sakano
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-29 00:00:00.000000000 Z
+date: 2014-05-02 00:00:00.000000000 Z
 dependencies: []
 description: Package for a subclass of Range, RangeExtd and RangeExtd::Infinity.  The
   former defines a range that enables an exclusion of the begin boundary, in addition