Method captures_read

regex/src/re_unicode.rs:671–677

This is like `captures`, but uses [`CaptureLocations`](struct.CaptureLocations.html) instead of [`Captures`](struct.Captures.html) in order to amortize allocations. To create a `CaptureLocations` value, use the `Regex::capture_locations` method. This returns the overall match if this was successful, which is always equivalence to the `0`th capture group.

(
        &self,
        locs: &mut CaptureLocations,
        text: &'t str,
    )

    /// This returns the overall match if this was successful, which is always
    /// equivalence to the `0`th capture group.
    pub fn captures_read<'t>(
        &self,
        locs: &mut CaptureLocations,
        text: &'t str,
    ) -> Option<Match<'t>> {
        self.captures_read_at(locs, text, 0)
    }

    /// Returns the same as captures, but starts the search at the given
    /// offset and populates the capture locations given.