[backport] SI-8705 Added example to Option.contains method.

(cherry picked from commit 1e2a21681a4a55469faa59b07473a3b269e70258)

1 files changed, 11 insertions, 0 deletions

diff --git a/src/library/scala/Option.scala b/src/library/scala/Option.scala
index 5a1c832fae..9371775d67 100644
--- a/src/library/scala/Option.scala
+++ b/src/library/scala/Option.scala
@@ -211,6 +211,17 @@ sealed abstract class Option[+A] extends Product with Serializable {
 
   /** Tests whether the option contains a given value as an element.
    *
+   * @example {{{
+   * // Returns true because Some instance contains string "something" which equals "something".
+   * Some("something") contains "something"
+   *
+   * // Returns false because "something" != "anything".
+   * Some("something") contains "anything"
+   *
+   * // Returns false when method called on None.
+   * None contains "anything"
+   * }}}
+   *
    *  @param elem the element to test.
    *  @return `true` if the option has an element that is equal (as
    *  determined by `==`) to `elem`, `false` otherwise.