instance method · added in Ruby 3.4

MatchData#byteend

(::MatchData::capture backref) -> ::Integer?

byteend(n) → integer

byteend(name) → integer

static VALUE
match_byteend(VALUE match, VALUE n)
{
    int i = match_backref_number(match, n);
    struct re_registers *regs = RMATCH_REGS(match);

    match_check(match);
    backref_number_check(regs, i);

    if (BEG(i) < 0)
        return Qnil;
    return LONG2NUM(END(i));
}

Returns the offset (in bytes) of the end of the specified match.

When non-negative integer argument n is given, returns the offset of the end of the nth match:

Example

m = /(.)(.)(\d+)(\d)/.match("THX1138.")
# => #<MatchData "HX1138" 1:"H" 2:"X" 3:"113" 4:"8">
m[0]     # => "HX1138"
m.byteend(0) # => 7
m[3]     # => "113"
m.byteend(3) # => 6

m = /(т)(е)(с)/.match('тест')
# => #<MatchData "тес" 1:"т" 2:"е" 3:"с">
m[0]     # => "тес"
m.byteend(0) # => 6
m[3]     # => "с"
m.byteend(3) # => 6

When string or symbol argument name is given, returns the offset of the end for the named match:

Example

m = /(?<foo>.)(.)(?<bar>.)/.match("hoge")
# => #<MatchData "hog" foo:"h" bar:"g">
m[:foo]      # => "h"
m.byteend('foo') # => 1
m[:bar]      # => "g"
m.byteend(:bar)  # => 3

Ruby version changes

3.4
- MatchData#bytebegin and MatchData#byteend have been added. [Feature #20576]

See also #bytebegin #byteoffset #begin #captures also in 4.1 · 3.4

‹ prev#bytebegin next ›#byteoffset