instance method

StringScanner#values_at

(*::Integer) -> ::Array[::String]?

values_at(*specifiers) → array_of_captures or nil

static VALUE
strscan_values_at(int argc, VALUE *argv, VALUE self)
{
    struct strscanner *p;
    long i;
    VALUE new_ary;

    GET_SCANNER(self, p);
    if (! MATCHED_P(p))        return Qnil;

    new_ary = rb_ary_new2(argc);
    for (i = 0; i<argc; i++) {
        rb_ary_push(new_ary, strscan_aref(self, argv[i]));
    }

    return new_ary;
}

Returns an array of captured substrings, or nil of none.

For each specifier, the returned substring is [specifier]; see [].

Example

scanner = StringScanner.new('Fri Dec 12 1975 14:39')
pattern = /(?<wday>\w+) (?<month>\w+) (?<day>\d+) /
scanner.match?(pattern)
scanner.values_at(*0..3)               # => ["Fri Dec 12 ", "Fri", "Dec", "12"]
scanner.values_at(*%i[wday month day]) # => ["Fri", "Dec", "12"]

See also #unscan #terminate also in 4.1 · 3.4 · 3.3 · 3.2 · 3.1 · 3.0

‹ prev#unscan