This release exposes some new lower level APIs on Regex
that permit
amortizing allocation and controlling the location at which a search is
performed in a more granular way. Most users of the regex crate will not
need or want to use these APIs.
New features:
Bug fixes:
RegexBuilder::dot_matches_new_line
.Parser::allow_invalid_utf8
in the
regex-syntax
crate.This release upgrades regex's Unicode tables to Unicode 11, and enables SIMD optimizations automatically on Rust stable (1.27 or newer).
New features:
size_hint
on RegexSet
match iterators.Bug fixes:
use_std
feature isn't used.This release marks the 1.0 release of regex.
While this release includes some breaking changes, most users of older versions of the regex library should be able to migrate to 1.0 by simply bumping the version number. The important changes are as follows:
RegexBuilder
.(?-u:\B)
is no longer allowed in Unicode regexes since it can match at
invalid UTF-8 code unit boundaries. (?-u:\b)
is still allowed in Unicode
regexes.From<regex_syntax::Error>
impl has been removed. This formally removes
the public dependency on regex-syntax
.use_std
, has been added and enabled by default. Disabling
the feature will result in a compilation error. In the future, this may
permit us to support no_std
environments (w/ alloc
) in a backwards
compatible way.For more information and discussion, please see 1.0 release tracking issue.
This release primarily contains bug fixes. Some of them resolve bugs where the parser could panic.
New features:
Bug fixes:
[\d-a]
.\n
character.(?flags)
.\pC
was not recognized as an alias for \p{Other}
.This release primarily updates the regex crate to changes made in std::arch
on nightly Rust.
New features:
Hir
type in regex-syntax
now has a printer.This release introduces a new nightly only feature, unstable
, which enables
SIMD optimizations for certain types of regexes. No additional compile time
options are necessary, and the regex crate will automatically choose the
best CPU features at run time. As a result, the simd
(nightly only) crate
dependency has been dropped.
New features:
Bug fixes:
(?x)[ / - ]
failed to parse.Bug gixes:
This release includes a ground-up rewrite of the regex-syntax crate, which has been in development for over a year.
New features:
&&
, --
and ~~
binary
operators within classes.\p{..}
character classes.
Things like \p{scx:Hira}
, \p{age:3.2}
or \p{Changes_When_Casefolded}
now work. All property name and value aliases are supported, and properties
are selected via loose matching. e.g., \p{Greek}
is the same as
\p{G r E e K}
.UNICODE.md
document has been added to this repository that
exhaustively documents support for UTS#18.()+
is
now a valid regex.Ast
type in regex-syntax
now contains span information.\u
, \u{...}
, \U
and \U{...}
syntax for specifying code points
in a regular expression.Replace::by_ref
adapter for use of a replacer without consuming it.Bug fixes:
Bug fixes:
Bug fixes:
New features:
Bug fixes:
simd
has been bumped to 0.2.1
, which fixes a Rust nightly build error.New features:
impl From<Match> for &str
.Clone
and PartialEq
on Error
.Bug fixes:
replace
methods for empty matches.New features:
[\p{Greek}&&\pL]
matches greek letters and
[[0-9]&&[^4]]
matches every decimal digit except 4
.
(Much thanks to @robinst, who contributed this awesome feature.)Bug fixes:
(?x)
flag.Captures::get
to API documentation.(?x)
is used.rure_captures_len
in the C binding.One major bug with replace_all
has been fixed along with a couple of other
touchups.
NoExpand
to reference correct lifetime parameter.replace_all
when replacing a match with the empty string.0.2.0
CHANGELOG entry.
(RegexBuilder::compile
was renamed to RegexBuilder::build
.)regex
should only require one version of memchr
crate.This is a new major release of the regex crate, and is an implementation of the
regex 1.0 RFC.
We are releasing a 0.2
first, and if there are no major problems, we will
release a 1.0
shortly. For 0.2
, the minimum supported Rust version is
1.12.
There are a number of breaking changes in 0.2
. They are split into two
types. The first type correspond to breaking changes in regular expression
syntax. The second type correspond to breaking changes in the API.
Breaking changes for regex syntax:
[:upper:]
would parse as the upper
POSIX character class. Now it parses
as the character class containing the characters :upper:
. The fix to this
change is to use [[:upper:]]
instead. Note that variants like
[[:upper:][:blank:]]
continue to work.[
must always be escaped inside a character class.&
, -
and ~
must be escaped if any one of them are
repeated consecutively. For example, [&]
, [\&]
, [\&\&]
, [&-&]
are all
equivalent while [&&]
is illegal. (The motivation for this and the prior
change is to provide a backwards compatible path for adding character class
set notation.)bytes::Regex
now has Unicode mode enabled by default (like the main
Regex
type). This means regexes compiled with bytes::Regex::new
that
don't have the Unicode flag set should add (?-u)
to recover the original
behavior.Breaking changes for the regex API:
find
and find_iter
now return Match
values instead of
(usize, usize)
. Match
values have start
and end
methods, which
return the match offsets. Match
values also have an as_str
method,
which returns the text of the match itself.Captures
type now only provides a single iterator over all capturing
matches, which should replace uses of iter
and iter_pos
. Uses of
iter_named
should use the capture_names
method on Regex
.at
method on the Captures
type has been renamed to get
, and it
now returns a Match
. Similarly, the name
method on Captures
now returns
a Match
.replace
methods now return Cow
values. The Cow::Borrowed
variant
is returned when no replacements are made.Replacer
trait has been completely overhauled. This should only
impact clients that implement this trait explicitly. Standard uses of
the replace
methods should continue to work unchanged. If you implement
the Replacer
trait, please consult the new documentation.quote
free function has been renamed to escape
.Regex::with_size_limit
method has been removed. It is replaced by
RegexBuilder::size_limit
.RegexBuilder
type has switched from owned self
method receivers to
&mut self
method receivers. Most uses will continue to work unchanged, but
some code may require naming an intermediate variable to hold the builder.compile
method on RegexBuilder
has been renamed to build
.is_match
function has been removed. It is replaced by compiling
a Regex
and calling its is_match
method.PartialEq
and Eq
impls on Regex
have been dropped. If you relied
on these impls, the fix is to define a wrapper type around Regex
, impl
Deref
on it and provide the necessary impls.is_empty
method on Captures
has been removed. This always returns
false
, so its use is superfluous.Syntax
variant of the Error
type now contains a string instead of
a regex_syntax::Error
. If you were examining syntax errors more closely,
you'll need to explicitly use the regex_syntax
crate to re-parse the regex.InvalidSet
variant of the Error
type has been removed since it is
no longer used.RegexSplits
has been renamed to Split
.A number of bugs have been fixed:
Replacer
trait has been changed to permit the caller to control
allocation.is_match
function.0.1
) and remove with_size_limit
.Captures
now have the correct lifetime parameters.PartialEq
and Eq
impls on Regex
.is_empty
from Captures
since it always returns false.Captures
.regex-syntax 0.3.4
.regex-syntax
dependency version for regex
to 0.3.4
.bytes::Regex::replace
where extend
was used
instead of extend_from_slice
.regex!
compiler plugin macro.0.1.66
was
yanked.)re$
, it will be matched in reverse from the end of the
haystack.unsafe
in regex
(to elide bounds checks).mempool
crate (which used thread local storage) was replaced
with a faster version of a similar API in @Amanieu's thread_local
crate.
It should reduce contention when using a regex from multiple threads
simultaneously.bytes::Regex
.Captures
now has a Debug
impl.