regex: expose lower level search APIs#493
Merged
BurntSushi merged 1 commit intorust-lang:masterfrom Jul 18, 2018
Merged
Conversation
Member
Author
|
cc @raphlinus I think you mentioned looking for these APIs at one point in the long ago. These have been available as undocumented APIs for quite a while, but now I actually need them for another project and I think they've mostly served me well. |
This commit exposes two new areas of API surface:
1. A new `captures_read` method which provides a way to access the
offsets of submatches while amortizing the allocation of the
space required to store those offsets. Callers should still of
course prefer to use the higher level `captures` method, but if
performance dictates, this lower level API may be useful.
2. New "at" variants of
shortest_match/is_match/find/captures/captures_read that permit
controlling where the start of a search begins within a slice.
This is typically useful for controlling the match semantics of
look-around operators such as `^` and `$`, and are necessary for
implementing non-overlapping iterators.
Fixes rust-lang#219
a734dd0 to
4c59b70
Compare
Member
Author
|
I've been using these new APIs for a bit now and everything feels OK to me. So I'm going to bring this in and push out a new release. |
This was referenced Oct 13, 2025
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This commit exposes two new areas of API surface:
captures_readmethod which provides a way to access theoffsets of submatches while amortizing the allocation of the
space required to store those offsets. Callers should still of
course prefer to use the higher level
capturesmethod, but ifperformance dictates, this lower level API may be useful.
shortest_match/is_match/find/captures/captures_read that permit
controlling where the start of a search begins within a slice.
This is typically useful for controlling the match semantics of
look-around operators such as
^and$, and are necessary forimplementing non-overlapping iterators.
Fixes #219