Maintenance Ruby 3.3 gets fixes, but no new features. Switch to Ruby 4.0 →
instance method
String#upto
upto(other_string, exclusive = false) {|string| ... } → self
upto(other_string, exclusive = false) → new_enumerator
string.c
View on GitHub ↗
static VALUE
rb_str_upto(int argc, VALUE *argv, VALUE beg)
{
VALUE end, exclusive;
rb_scan_args(argc, argv, "11", &end, &exclusive);
RETURN_ENUMERATOR(beg, argc, argv);
return rb_str_upto_each(beg, end, RTEST(exclusive), str_upto_i, Qnil);
}
With a block given, calls the block with each String value returned by successive calls to String#succ; the first value is self, the next is self.succ, and so on; the sequence terminates when value other_string is reached; returns self:
Example
'a8'.upto('b6') {|s| print s, ' ' } # => "a8"
Output:
Example
a8 a9 b0 b1 b2 b3 b4 b5 b6
If argument exclusive is given as a truthy object, the last value is omitted:
Example
'a8'.upto('b6', true) {|s| print s, ' ' } # => "a8"
Output:
Example
a8 a9 b0 b1 b2 b3 b4 b5
If other_string would not be reached, does not call the block:
Example
'25'.upto('5') {|s| fail s } 'aa'.upto('a') {|s| fail s }
With no block given, returns a new Enumerator:
Example
'a8'.upto('b6') # => #<Enumerator: "a8":upto("b6")>