extends the Object type with the tasty 'in?' method, which returns true if an object is included in a list or other enumerable value
Ruby
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
test
.document
.gitignore
LICENSE
README.rdoc
Rakefile
VERSION
in_enumerable.gemspec

README.rdoc

in_enumerable

A simple but nice language extension.

in_enumerable extends the Object type with the tasty 'in?' method, which returns true if an object is included in a list or other enumerable value. So you can do this:

1.in? [1,2]          # => true
3.in? [1,2]          # => false

instead of the slightly more awkward:

[1,2].include?(1)    # => true
[1,2].include?(3)    # => false

Despite its name, in_enumerable doesn't require an enumerable type. It uses duck typing to work with any type that has an 'include?' method, such as:

# Array (see examples above)

# Hash
h = { "a" => 100, "b" => 200 }
"a".in?(h)           # => true
"z".in?(h)           # => false

# String
"lo".in?("hello")    # => true
"ol".in?("hello")    # => false
?h.in?("hello")      # => true

# Range
25.in?(1..50)        # => true
75.in?(1..50)        # => false

# Set
require 'set'
s = Set.new([1,2])
1.in?(s)             # => true
3.in?(s)             # => false

# Even Module
module A
end
class B
  include A
end
class C < B
end
A.in?(B)             # => true
A.in?(C)             # => true
A.in?(A)             # => false

Installation

gem install in_enumerable

Usage

require 'rubygems'
require 'in_enumerable'

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.

Copyright

Copyright © 2009 Brian Morearty. See LICENSE for details.