Loosen lifetime bounds on accessing named captures via Index.

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "regex"
-version = "0.1.48"  #:version
+version = "0.1.49"  #:version
 authors = ["The Rust Project Developers"]
 license = "MIT/Apache-2.0"
 readme = "README.md"

src/re.rs

@@ -951,6 +951,15 @@ impl<'t> Captures<'t> {
 
 /// Get a group by index.
 ///
+/// `'t` is the lifetime of the matched text.
+///
+/// The text can't outlive the `Captures` object if this method is
+/// used, because of how `Index` is defined (normally `a[i]` is part
+/// of `a` and can't outlive it); to do that, use [`at()`][]
+/// instead.
+///
+/// [`at()`]: #method.at
+///
 /// # Panics
 /// If there is no group at the given index.
 impl<'t> Index<usize> for Captures<'t> {
@@ -965,13 +974,23 @@ impl<'t> Index<usize> for Captures<'t> {
 
 /// Get a group by name.
 ///
+/// `'t` is the lifetime of the matched text and `'i` is the lifetime
+/// of the group name (the index).
+///
+/// The text can't outlive the `Captures` object if this method is
+/// used, because of how `Index` is defined (normally `a[i]` is part
+/// of `a` and can't outlive it); to do that, use [`name()`][]
+/// instead.
+///
+/// [`name()`]: #method.name
+///
 /// # Panics
 /// If there is no group named by the given value.
-impl<'t> Index<&'t str> for Captures<'t> {
+impl<'t, 'i> Index<&'i str> for Captures<'t> {
 
     type Output = str;
 
-    fn index<'a>(&'a self, name: &str) -> &'a str {
+    fn index<'a>(&'a self, name: &'i str) -> &'a str {
         match self.name(name) {
             None => panic!("no group named '{}'", name),
             Some(ref s) => s,
@@ -1261,4 +1280,16 @@ mod test {
         let cap = re.captures("abc").unwrap();
         let _ = cap["bad name"];
     }
+
+    #[test]
+    fn test_cap_index_lifetime() {
+        // This is a test of whether the types on `caps["..."]` are general
+        // enough.  If not, this will fail to typecheck.
+        fn inner(s: &str) -> usize {
+            let re = Regex::new(r"(?P<number>\d+)").unwrap();
+            let caps = re.captures(s).unwrap();
+            caps["number"].len()
+        }
+        assert_eq!(inner("123"), 3);
+    }
 }