End of Life Ruby 3.2 has reached end of life and gets no more fixes. Switch to Ruby 4.0 →

instance method

StringScanner#pos=

pos=(n)

static VALUE
strscan_set_pos(VALUE self, VALUE v)
{
    struct strscanner *p;
    long i;

    GET_SCANNER(self, p);
    i = NUM2INT(v);
    if (i < 0) i += S_LEN(p);
    if (i < 0) rb_raise(rb_eRangeError, "index out of range");
    if (i > S_LEN(p)) rb_raise(rb_eRangeError, "index out of range");
    p->curr = i;
    return LONG2NUM(i);
}

Sets the byte position of the scan pointer.

Example

s = StringScanner.new('test string')
s.pos = 7            # -> 7
s.rest               # -> "ring"

See also #pos #post_match #pointer= #pre_match also in 4.1 · 4.0 · 3.4 · 3.3 · 3.1 · 3.0

‹ prev#pos next ›#post_match