explain how to search without owned data

diff --git a/src/libcore/slice/mod.rs b/src/libcore/slice/mod.rs
index 363ae088275586239e95a53f337b0e9c2ab1905b..c3eb2ec9dc251b611bc4a67d3d65632112819ab6 100644 (file)
--- a/src/libcore/slice/mod.rs
+++ b/src/libcore/slice/mod.rs
@@ -1263,6 +1263,14 @@ pub fn rsplitn_mut<F>(&mut self, n: usize, pred: F) -> RSplitNMut<'_, T, F>
     /// assert!(v.contains(&30));
     /// assert!(!v.contains(&50));
     /// ```
+    ///
+    /// If you only have a borrowed `T`, use `any`:
+    ///
+    /// ```
+    /// let v = [String::from("hello"), String::from("world")];
+    /// assert!(v.iter().any(|e| e == "hello"));
+    /// assert!(!v.iter().any(|e| e == "hi"));
+    /// ```
     #[stable(feature = "rust1", since = "1.0.0")]
     pub fn contains(&self, x: &T) -> bool
         where T: PartialEq