Sha256: 8fae400df96215fd957585fb46de3a6b129c1e2412265245d2493f9916485c1b

Contents?: true

Size: 1.5 KB

Versions: 26

Compression:

Stored size: 1.5 KB

Contents

#--
# Credit goes to Florian Gross.
#++
module Comparable

  # Returns self if above the given lower bound, or
  # within the given lower and upper bounds,
  # otherwise returns the the bound of which the
  # value falls outside.
  #
  #   4.clip(3)    #=> 4
  #   4.clip(5)    #=> 5
  #   4.clip(2,7)  #=> 4
  #   9.clip(2,7)  #=> 7
  #   1.clip(2,7)  #=> 2
  #
  def clip(lower, upper=nil)
    return lower if self < lower
    return self unless upper
    return upper if self > upper
    return self
  end

  # Returns the greater of self or x.
  #
  #   4.cap(5)  #=> 4
  #   6.cap(5)  #=> 5
  #
  def cap(upper)
    (self <= upper) ? self : upper
  end

end


#  _____         _
# |_   _|__  ___| |_
#   | |/ _ \/ __| __|
#   | |  __/\__ \ |_
#   |_|\___||___/\__|
#
=begin test

  require 'test/unit'

  class TCComparable < Test::Unit::TestCase

    def test_clip
      assert_equal( 4, 3.clip(4) )
      assert_equal( 4, 4.clip(4) )
      assert_equal( 5, 5.clip(4) )
      assert_equal( 4, 4.clip(3,5) )
      assert_equal( 3, 3.clip(3,5) )
      assert_equal( 5, 5.clip(3,5) )
      assert_equal( 3, 2.clip(3,5) )
      assert_equal( 5, 6.clip(3,5) )
      assert_equal( 'd', 'd'.clip('c','e') )
      assert_equal( 'c', 'c'.clip('c','e') )
      assert_equal( 'e', 'e'.clip('c','e') )
      assert_equal( 'c', 'b'.clip('c','e') )
      assert_equal( 'e', 'f'.clip('c','e') )
    end

    def test_cap
      assert_equal( 3, 3.cap(4) )
      assert_equal( 4, 4.cap(4) )
      assert_equal( 4, 5.cap(4) )
    end

  end

=end

Version data entries

26 entries across 26 versions & 1 rubygems

Version Path
facets-0.9.0 lib/nano/comparable/clip.rb
facets-1.0.3 packages/core/lib/facet/comparable/clip.rb
facets-1.0.0 lib/facet/comparable/clip.rb
facets-1.2.1 lib/facets/core/comparable/clip.rb
facets-1.2.0 lib/facets/core/comparable/clip.rb
facets-1.3.0 lib/facets/core/comparable/clip.rb
facets-1.1.0 lib/facet/comparable/clip.rb
facets-1.3.1 lib/facets/core/comparable/clip.rb
facets-1.3.3 lib/facets/core/comparable/clip.rb
facets-1.3.2 lib/facets/core/comparable/clip.rb
facets-1.4.2 lib/facets/core/comparable/clip.rb
facets-1.4.0 lib/facets/core/comparable/clip.rb
facets-1.4.1 lib/facets/core/comparable/clip.rb
facets-1.4.3 lib/facets/core/comparable/clip.rb
facets-1.4.4 lib/facets/core/comparable/clip.rb
facets-1.4.5 lib/facets/core/comparable/clip.rb
facets-1.7.38 lib/facets/core/comparable/clip.rb
facets-1.7.0 lib/facets/core/comparable/clip.rb
facets-1.7.30 lib/facets/core/comparable/clip.rb
facets-1.7.46 lib/facets/core/comparable/clip.rb