README.md in array_include_methods-1.3.0 vs README.md in array_include_methods-1.4.0
- old
+ new
@@ -1,6 +1,6 @@
-# ArrayIncludeMethods 1.3.0 - Ruby Refinement
+# ArrayIncludeMethods 1.4.0 - Ruby Refinement
[](http://badge.fury.io/rb/array_include_methods)
[](https://travis-ci.com/AndyObtiva/array_include_methods)
[](https://coveralls.io/github/AndyObtiva/array_include_methods?branch=master)
`Array#include_all?` & `Array#include_any?` methods missing from basic Ruby `Array` API.
@@ -10,11 +10,11 @@
### With Bundler:
Include the following in Gemfile:
```ruby
-gem 'array_include_methods', '~> 1.3.0'
+gem 'array_include_methods', '~> 1.4.0'
```
Run:
```
@@ -24,11 +24,11 @@
### Without Bundler:
Run:
```
-gem install array_include_methods -v1.3.0
+gem install array_include_methods -v1.4.0
```
## Usage
Add the following line to your application if you are not requiring all gems via Bundler (e.g. `Bundler.require(:default)`):
@@ -92,9 +92,41 @@
[1, 2, 3, 4].array_index([2, 4]) # returns -1
[1, 2, 3, 4].array_index([4, 2]) # returns -1
[1, 2, 3, 4].array_index([2, 4, 5]) # returns -1
[1, 2, 3, 4].array_index([]) # returns -1
[1, 2, 3, 4].array_index(nil) # returns -1
+```
+
+### `Array#array_intersection_indexes(other_array)`
+(alias: `Array#array_intersection_indices(other_array)`)
+
+Returns indexes from `self` array for which elements match elements in `other_array` assuming same sort
+
+```ruby
+[1, 2, 3, 4].array_intersection_indexes([2, 3, 4]) # returns [1, 2, 3]
+[1, 2, 3, 4].array_intersection_indexes([2, 3]) # returns [1, 2]
+[1, 2, 3, 4].array_intersection_indexes([3, 4]) # returns [2, 3]
+[1, 2, 3, 4].array_intersection_indexes([2, 4]) # returns [1, 3]
+[1, 2, 3, 4].array_intersection_indexes([4, 2]) # returns [3]
+[1, 2, 3, 4].array_intersection_indexes([2, 4, 5]) # returns [1, 3]
+[1, 2, 3, 4].array_intersection_indexes([]) # returns []
+[1, 2, 3, 4].array_intersection_indexes(nil) # returns []
+```
+
+### `Array#array_diff_indexes(other_array)`
+(alias: `Array#array_diff_indices(other_array)`)
+
+Returns indexes from `self` array for which elements do not match elements in `other_array` assuming same sort
+
+```ruby
+[1, 2, 3, 4].array_diff_indexes([2, 3, 4]) # returns [0]
+[1, 2, 3, 4].array_diff_indexes([2, 3]) # returns [0, 3]
+[1, 2, 3, 4].array_diff_indexes([3, 4]) # returns [0, 1]
+[1, 2, 3, 4].array_diff_indexes([2, 4]) # returns [0, 2]
+[1, 2, 3, 4].array_diff_indexes([4, 2]) # returns [0, 1, 2]
+[1, 2, 3, 4].array_diff_indexes([2, 4, 5]) # returns [0, 2]
+[1, 2, 3, 4].array_diff_indexes([]) # returns [0, 1, 2, 3]
+[1, 2, 3, 4].array_diff_indexes(nil) # returns [0, 1, 2, 3]
```
## Opal Compatibility
This gem degrades gracefully to monkey-patching in [Opal Ruby](https://opalrb.com) and provides a `using` method shim so consumer code does not have to change if it used gems that rely on the Ruby refinement