Feature #20080
Updated by stuyam (Stuart Yamartino) 5 months ago
Followup Reference: #20027
This feature request is to implement a method called `#begin_and_end` on `Range` that returns an array of the first and last value stored in a range:
```ruby
(1..300).begin_and_end #=> [1, 300]
first, last = (300..1).begin_and_end
first #=> 300
last #=> 1
```
I believe this would be a great addition to Ranges as they are often used to pass around a single object used to hold endpoints, and this allows easier retrieval of those endpoints.
This would allow easier deconstruction into start and end values using array deconstruction as well as a simpler way to serialize to a more primitive object such as an array for database storage.
This implementation was suggested by @mame in my initial feature suggestion regarding range deconstruction: https://bugs.ruby-lang.org/issues/20027
This implementation would work similar to how `#minmax` works where it returns an array of two numbers, however the difference is that `#minmax` doesn't work with reverse ranges as @Dan0042 pointed out in the link above:
```ruby
(1..42).minmax #=> [1, 42]
(42..1).minmax #=> [nil, nil]
```
**Updated Proposal:**
1. Call the method `#bounds` rather than `#begin_and_end`.
```ruby
first, last = (1..300).bounds # => [1, 300]
first, last = (300..1).bounds # => [300, 1]
first, last = (..300).bounds # => [nil, 300]
first, last = (1..).bounds # => [1, nil]
```
2. Add `exclude_end?` support so re-hydration of Range works:
```ruby
b = (1..2).bounds #=> [1,2]
Range.new(*b) #=> 1..2
b = (1...2).bounds #=> [1,2,true]
Range.new(*b) #=> 1...2
```
3. Options for controlling when and if `exclude_end?` is included:
```ruby
# automatic by default, only shows when exclude_end? is true
# useful for re-hydration and doing the right thing in most cases
(1..2).bounds #=> [1,2]
(1...2).bounds #=> [1,2,true]
# show exclude_end? always
# useful for mixed range usage in logic that needs to know the end, or storing in a table where you want to be explicit
(1..2).bounds(true) #=> [1,2,false]
(1...2).bounds(true) #=> [1,2,true]
# never show exclude_end?
# useful for sending to a front end or something where you just need the bounds
(1..2).bounds(false) #=> [1,2]
(1...2).bounds(false) #=> [1,2]
```