(3fdd6e8fcd4f63b56b4ae6ac3c04e4604a6053ac)
#include "ruby/internal/config.h"
#include <stdio.h>
#include "ruby/onigmo.h"
#include "ruby/regex.h"
#include "ruby/internal/core/rmatch.h"
#include "ruby/internal/dllexport.h"
Go to the source code of this file.
|
| VALUE | rb_reg_regcomp (VALUE str) |
| | Creates a new instance of rb_cRegexp.
|
| |
| rb_len_t | rb_reg_search (VALUE re, VALUE str, rb_len_t pos, int dir) |
| | Runs the passed regular expression over the passed string.
|
| |
| VALUE | rb_reg_regsub (VALUE repl, VALUE src, struct re_registers *regs, VALUE rexp) |
| | Substitution.
|
| |
| rb_len_t | rb_reg_adjust_startpos (VALUE re, VALUE str, rb_len_t pos, int dir) |
| | Tell us if this is a wrong idea, but it seems this function has no usage at all.
|
| |
| VALUE | rb_reg_quote (VALUE str) |
| | Escapes any characters that would have special meaning in a regular expression.
|
| |
| 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.
|
| |
| OnigPosition | rb_reg_onig_match (VALUE re, VALUE str, OnigPosition(*match)(regex_t *reg, VALUE str, struct re_registers *regs, void *args), void *args, struct re_registers *regs) |
| | Runs a regular expression match using function match.
|
| |
| int | rb_reg_region_copy (struct re_registers *dst, const struct re_registers *src) |
| | Duplicates a match data.
|
| |
- Author
- $Author$
- Date
- Thu Sep 30 14:18:32 JST 1993
- Copyright
- Copyright (C) 1993-2007 Yukihiro Matsumoto
-
This file is a part of the programming language Ruby. Permission is hereby granted, to either redistribute and/or modify this file, provided that the conditions mentioned in the file COPYING are met. Consult the file for details.
Definition in file re.h.
◆ rb_reg_adjust_startpos()
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] | re | Regular expression to execute. |
| [in] | str | Target string to search. |
| [in] | pos | Offset in str to start searching, in bytes. |
| [in] | dir | pos' 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 2298 of file re.c.
◆ rb_reg_onig_match()
Runs a regular expression match using function match.
Performs preparation, error handling, and memory cleanup.
- Parameters
-
| [in] | re | Target regular expression. |
| [in] | str | What re is about to run on. |
| [in] | match | The function to run to match str against re. |
| [in] | args | Pointer to arguments to pass into match. |
| [out] | regs | Registers on a successful match. |
- Exceptions
-
| rb_eArgError | `re` does not fit for `str`. |
| rb_eEncCompatError | `re` and `str` are incompatible. |
| rb_eRegexpError | `re` is malformed. |
- Returns
- Match position on a successful match,
ONIG_MISMATCH otherwise.
Definition at line 2270 of file re.c.
◆ rb_reg_prepare_re()
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] | re | Target regular expression. |
| [in] | str | What re is about to run on. |
- Exceptions
-
| rb_eArgError | `re` does not fit for `str`. |
| rb_eEncCompatError | `re` and `str` are incompatible. |
| rb_eRegexpError | `re` is malformed. |
- Returns
- A preprocessesed pattern buffer ready to be applied to
str.
- Warning
- Do not use this function. Use rb_reg_onig_match() instead. It is kept only for old extensions. Its ownership rules are error prone: unless the return value is
RREGEXP_PTR(re), the caller must free it with onig_free().
Definition at line 2264 of file re.c.
◆ rb_reg_quote()
Escapes any characters that would have special meaning in a regular expression.
- Parameters
-
| [in] | str | Target string to escape. |
- Returns
- A copy of
str whose contents are escaped.
Definition at line 4969 of file re.c.
◆ rb_reg_regcomp()
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] | str | Source code in String. |
- Returns
- Allocated new instance of rb_cRegexp.
Definition at line 4251 of file re.c.
◆ rb_reg_region_copy()
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] | dst | Target registers to fill. |
| [in] | src | Source registers to duplicate. |
- Exceptions
-
| rb_eNoMemError | Not enough memory. |
- Return values
-
| 0 | Successful |
| ONIGERR_MEMORY | Not enough memory, even after GC (unlikely). |
- Postcondition
dst has identical contents to src.
Definition at line 1135 of file re.c.
◆ rb_reg_regsub()
Substitution.
This is basically the implementation of String#sub. Also String#gsub repeatedly calls this function.
- Parameters
-
| [in] | repl | Replacement string, e.g. "\\1\\2" |
| [in] | src | Source string, to be replaced. |
| [in] | regs | Matched data generated by applying rexp to src. |
| [in] | rexp | Regular expression. |
- Returns
- A substituted string.
Definition at line 5465 of file re.c.
◆ rb_reg_search()
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] | re | Regular expression to execute. |
| [in] | str | Target string to search. |
| [in] | pos | Offset in str to start searching, in bytes. |
| [in] | dir | pos' direction; 0 means left-to-right, 1 for the opposite. |
- Exceptions
-
| rb_eArgError | `re` is broken. |
| rb_eRegexpError | `re` is malformed. |
- Return values
-
| -1 | Match failed. |
| otherwise | Offset of first such byte where match happened. |
- Postcondition
Regexp.last_match is updated.
-
$&, $~, etc., are updated.
Definition at line 2421 of file re.c.