Struct RRegexp

#[repr(C)]
pub struct RRegexp {
    pub basic: RBasic,
    pub ptr: *mut re_pattern_buffer,
    pub src: VALUE,
    pub usecnt: c_ulong,
}

Ruby’s regular expression. A regexp is compiled into its own intermediate representation. This one holds that info. Regexp “match” operation then executes that IR.

Generated by rb-sys for Ruby mri-x86_64-linux-gnu-3.2.3

Fields

basic: RBasic

Basic part, including flags and class.

Generated by rb-sys for Ruby mri-x86_64-linux-gnu-3.2.3

ptr: *mut re_pattern_buffer

The pattern buffer. This is a quasi-opaque struct that holds compiled intermediate representation of the regular expression.

@note Compilation of a regexp could be delayed until actual match.

Generated by rb-sys for Ruby mri-x86_64-linux-gnu-3.2.3

src: VALUE

Source code of this expression.

Generated by rb-sys for Ruby mri-x86_64-linux-gnu-3.2.3

usecnt: c_ulong

Reference count. A regexp match can take extraordinarily long time to run. Ruby’s regular expression is heavily extended and not a regular language any longer; runs in NP-time in practice. Now, Ruby also has threads and GVL. In order to prevent long GVL lockup, our regexp engine can release it on occasions. This means that multiple threads can touch a regular expressions at once. That itself is okay. But their cleanup phase shall wait for all the concurrent runs, to prevent use-after-free situation. This field is used to count such threads that are executing this particular pattern buffer.

@warning Of course, touching this field from extension libraries causes catastrophic effects. Just leave it.

Generated by rb-sys for Ruby mri-x86_64-linux-gnu-3.2.3

Trait Implementations

impl Clone for RRegexp

fn clone(&self) -> RRegexp

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RRegexp

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for RRegexp

fn eq(&self, other: &RRegexp) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for RRegexp

impl Eq for RRegexp

impl StructuralPartialEq for RRegexp