Ruby 4.1.0dev (2026-09-10 revision e4120cace4c0289e08e8298fcd7824d7285e12fc)
Data Structures | Macros | Functions
rregexp.h File Reference

(e4120cace4c0289e08e8298fcd7824d7285e12fc)

Defines struct RRegexp. More...

#include "ruby/internal/attr/artificial.h"
#include "ruby/internal/attr/pure.h"
#include "ruby/internal/cast.h"
#include "ruby/internal/core/rbasic.h"
#include "ruby/internal/core/rstring.h"
#include "ruby/internal/value.h"
#include "ruby/internal/value_type.h"
Include dependency graph for rregexp.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  RRegexp
 Ruby's regular expression. More...
 

Macros

#define RREGEXP(obj)   RBIMPL_CAST((struct RRegexp *)(obj))
 Convenient casting macro.
 

Functions

static struct re_pattern_bufferRREGEXP_PTR (VALUE rexp)
 Convenient getter function.
 
static VALUE RREGEXP_SRC (VALUE rexp)
 Convenient getter function.
 
static char * RREGEXP_SRC_PTR (VALUE rexp)
 Convenient getter function.
 
static long RREGEXP_SRC_LEN (VALUE rexp)
 Convenient getter function.
 
static char * RREGEXP_SRC_END (VALUE rexp)
 Convenient getter function.
 

Detailed Description

Defines struct RRegexp.

Author
Ruby developers ruby-.nosp@m.core.nosp@m.@ruby.nosp@m.-lan.nosp@m.g.org
Warning
Symbols prefixed with either RBIMPL or rbimpl are implementation details. Don't take them as canon. They could rapidly appear then vanish. The name (path) of this header file is also an implementation detail. Do not expect it to persist at the place it is now. Developers are free to move it anywhere anytime at will.
Note
To ruby-core: remember that this header can be possibly recursively included from extension libraries written in C++. Do not expect for instance __VA_ARGS__ is always available. We assume C99 for ruby itself but we don't assume languages of extension libraries. They could be written in C++98.

Definition in file rregexp.h.

Macro Definition Documentation

◆ RREGEXP

#define RREGEXP (   obj)    RBIMPL_CAST((struct RRegexp *)(obj))

Convenient casting macro.

Parameters
objAn object, which is in fact an RRegexp.
Returns
The passed object casted to RRegexp.

Definition at line 37 of file rregexp.h.

Function Documentation

◆ RREGEXP_PTR()

static struct re_pattern_buffer * RREGEXP_PTR ( VALUE  rexp)
inlinestatic

Convenient getter function.

Parameters
[in]rexpThe regular expression in question.
Returns
The pattern buffer of the regular expression.
Precondition
rexp must be of RRegexp.

Definition at line 86 of file rregexp.h.

Referenced by rb_reg_onig_match(), and rb_reg_prepare_re().

◆ RREGEXP_SRC()

static VALUE RREGEXP_SRC ( VALUE  rexp)
inlinestatic

Convenient getter function.

Parameters
[in]rexpThe regular expression in question.
Returns
The source code of the regular expression.
Precondition
rexp must be of RRegexp.

Definition at line 102 of file rregexp.h.

Referenced by rb_reg_prepare_re(), RREGEXP_SRC_END(), RREGEXP_SRC_LEN(), and RREGEXP_SRC_PTR().

◆ RREGEXP_SRC_END()

static char * RREGEXP_SRC_END ( VALUE  rexp)
inlinestatic

Convenient getter function.

Parameters
[in]rexpThe regular expression in question.
Returns
The end of the source code of the regular expression.
Precondition
rexp must be of RRegexp.

Definition at line 162 of file rregexp.h.

◆ RREGEXP_SRC_LEN()

static long RREGEXP_SRC_LEN ( VALUE  rexp)
inlinestatic

Convenient getter function.

Parameters
[in]rexpThe regular expression in question.
Returns
The length of the source code of the regular expression.
Precondition
rexp must be of RRegexp.

Definition at line 143 of file rregexp.h.

Referenced by rb_reg_regcomp().

◆ RREGEXP_SRC_PTR()

static char * RREGEXP_SRC_PTR ( VALUE  rexp)
inlinestatic

Convenient getter function.

Parameters
[in]rexpThe regular expression in question.
Returns
The source code of the regular expression, in C's string.
Precondition
rexp must be of RRegexp.

Definition at line 124 of file rregexp.h.

Referenced by rb_reg_regcomp().