regex v0.2.0 Release Notes
-
๐ 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 a1.0
shortly. For0.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:
- POSIX character classes now require double bracketing. Previously, the regex
[:upper:]
would parse as theupper
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. - The character
[
must always be escaped inside a character class. - The characters
&
,-
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.) - 0๏ธโฃ A
bytes::Regex
now has Unicode mode enabled by default (like the mainRegex
type). This means regexes compiled withbytes::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
andfind_iter
now returnMatch
values instead of(usize, usize)
.Match
values havestart
andend
methods, which return the match offsets.Match
values also have anas_str
method, which returns the text of the match itself.- The
Captures
type now only provides a single iterator over all capturing matches, which should replace uses ofiter
anditer_pos
. Uses ofiter_named
should use thecapture_names
method onRegex
. - The
at
method on theCaptures
type has been renamed toget
, and it now returns aMatch
. Similarly, thename
method onCaptures
now returns aMatch
. - The
replace
methods now returnCow
values. TheCow::Borrowed
variant is returned when no replacements are made. - The
Replacer
trait has been completely overhauled. This should only impact clients that implement this trait explicitly. Standard uses of thereplace
methods should continue to work unchanged. If you implement theReplacer
trait, please consult the new documentation. - ๐ The
quote
free function has been renamed toescape
. - The
Regex::with_size_limit
method has been removed. It is replaced byRegexBuilder::size_limit
. - The
RegexBuilder
type has switched from ownedself
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. - ๐ The
compile
method onRegexBuilder
has been renamed tobuild
. - ๐ The free
is_match
function has been removed. It is replaced by compiling aRegex
and calling itsis_match
method. - The
PartialEq
andEq
impls onRegex
have been dropped. If you relied on these impls, the fix is to define a wrapper type aroundRegex
, implDeref
on it and provide the necessary impls. - ๐ The
is_empty
method onCaptures
has been removed. This always returnsfalse
, so its use is superfluous. - The
Syntax
variant of theError
type now contains a string instead of aregex_syntax::Error
. If you were examining syntax errors more closely, you'll need to explicitly use theregex_syntax
crate to re-parse the regex. - ๐ The
InvalidSet
variant of theError
type has been removed since it is no longer used. - Most of the iterator types have been renamed to match conventions. If you
were using these iterator types explicitly, please consult the documentation
for its new name. For example,
RegexSplits
has been renamed toSplit
.
๐ A number of bugs have been fixed:
- BUG #151:
The
Replacer
trait has been changed to permit the caller to control allocation. - BUG #165:
Remove the free
is_match
function. - BUG #166:
Expose more knobs (available in
0.1
) and removewith_size_limit
. - BUG #168:
Iterators produced by
Captures
now have the correct lifetime parameters. - BUG #175: Fix a corner case in the parsing of POSIX character classes.
- BUG #178:
Drop the
PartialEq
andEq
impls onRegex
. - BUG #179:
Remove
is_empty
fromCaptures
since it always returns false. - BUG #276:
Position of named capture can now be retrieved from a
Captures
. - BUG #296: Remove winapi/kernel32-sys dependency on UNIX.
- BUG #307: Fix error on emscripten.
- POSIX character classes now require double bracketing. Previously, the regex