Ruby 3.1.3p185 (2022-11-24 revision 1a6b16756e0ba6b95ab71a441357ed5484e33498)
Functions
re.h File Reference
#include "ruby/internal/config.h"
#include <stdio.h>
#include "ruby/regex.h"
#include "ruby/internal/core/rmatch.h"
#include "ruby/internal/dllexport.h"

Go to the source code of this file.

Functions

VALUE rb_reg_regcomp (VALUE str)
 Creates a new instance of rb_cRegexp. More...
 
long rb_reg_search (VALUE re, VALUE str, long pos, int dir)
 Runs the passed regular expression over the passed string. More...
 
VALUE rb_reg_regsub (VALUE repl, VALUE src, struct re_registers *regs, VALUE rexp)
 Substitution. More...
 
long rb_reg_adjust_startpos (VALUE re, VALUE str, long pos, int dir)
 Tell us if this is a wrong idea, but it seems this function has no usage at all. More...
 
VALUE rb_reg_quote (VALUE str)
 Escapes any characters that would have special meaning in a regular expression. More...
 
regex_trb_reg_prepare_re (VALUE re, VALUE str)
 Exercises various checks and preprocesses so that the given regular expression can be applied to the given string. More...
 
int rb_reg_region_copy (struct re_registers *dst, const struct re_registers *src)
 Duplicates a match data. More...
 

Detailed Description

Author
$Author$
Date
Thu Sep 30 14:18:32 JST 1993

Definition in file re.h.

Function Documentation

◆ rb_reg_adjust_startpos()

long rb_reg_adjust_startpos ( VALUE  re,
VALUE  str,
long  pos,
int  dir 
)

Tell us if this is a wrong idea, but it seems this function has no usage at all.

Just remains here for theoretical backwards compatibility.

Parameters
[in]reRegular expression to execute.
[in]strTarget string to search.
[in]posOffset in str to start searching, in bytes.
[in]dirpos' direction; 0 means left-to-right, 1 for the opposite.
Returns
Adjusted nearest offset to pos inside of str, where is a character boundary.

Definition at line 1587 of file re.c.

◆ rb_reg_prepare_re()

regex_t * rb_reg_prepare_re ( VALUE  re,
VALUE  str 
)

Exercises various checks and preprocesses so that the given regular expression can be applied to the given string.

The preprocess here includes (but not limited to) for instance encoding conversion.

Parameters
[in]reTarget regular expression.
[in]strWhat re is about to run on.
Exceptions
rb_eArgErrorre does not fit for str.
rb_eEncCompatErrorre and str are incompatible.
rb_eRegexpErrorre is malformed.
Returns
A preprocessesed pattern buffer ready to be applied to str.
Note
The return value is manages by our GC. Don't free.

Definition at line 1580 of file re.c.

◆ rb_reg_quote()

VALUE rb_reg_quote ( VALUE  str)

Escapes any characters that would have special meaning in a regular expression.

Parameters
[in]strTarget string to escape.
Returns
A copy of str whose contents are escaped.

Definition at line 3541 of file re.c.

◆ rb_reg_regcomp()

VALUE rb_reg_regcomp ( VALUE  str)

Creates a new instance of rb_cRegexp.

It can be seen as a specialised version of rb_reg_new_str() where it does not take options.

Parameters
[in]strSource code in String.
Returns
Allocated new instance of rb_cRegexp.

Definition at line 3053 of file re.c.

◆ rb_reg_region_copy()

int rb_reg_region_copy ( struct re_registers dst,
const struct re_registers src 
)

Duplicates a match data.

This is roughly the same as onig_region_copy(), except it tries to GC when there is not enough memory.

Parameters
[out]dstTarget registers to fill.
[in]srcSource registers to duplicate.
Exceptions
rb_eNoMemErrorNot enough memory.
Return values
0Successful
ONIGERR_MEMORYNot enough memory, even after GC (unlikely).
Postcondition
dst has identical contents to src.

Definition at line 955 of file re.c.

◆ rb_reg_regsub()

VALUE rb_reg_regsub ( VALUE  repl,
VALUE  src,
struct re_registers regs,
VALUE  rexp 
)

Substitution.

This is basically the implementation of String#sub. Also String#gsub repeatedly calls this function.

Parameters
[in]replReplacement string, e.g. "\\1\\2"
[in]srcSource string, to be replaced.
[in]regsMatched data generated by applying rexp to src.
[in]rexpRegular expression.
Returns
A substituted string.

Definition at line 3856 of file re.c.

◆ rb_reg_search()

long rb_reg_search ( VALUE  re,
VALUE  str,
long  pos,
int  dir 
)

Runs the passed regular expression over the passed string.

Unlike rb_reg_search() this function also takes position and direction of the search, which make it possible for this function to run from in middle of the string.

Parameters
[in]reRegular expression to execute.
[in]strTarget string to search.
[in]posOffset in str to start searching, in bytes.
[in]dirpos' direction; 0 means left-to-right, 1 for the opposite.
Exceptions
rb_eArgErrorre is broken.
rb_eRegexpErrorre is malformed.
Return values
-1Match failed.
otherwiseOffset of first such byte where match happened.
Postcondition
Regexp.last_match is updated.
$&, $~, etc., are updated.

Definition at line 1697 of file re.c.

Referenced by rb_reg_match2().