Update enum.ex docs for find_value (#9641)

1 files changed, 8 insertions, 0 deletions

diff --git a/lib/elixir/lib/enum.ex b/lib/elixir/lib/enum.ex
index 7cf155019..e7215a545 100644
--- a/lib/elixir/lib/enum.ex
+++ b/lib/elixir/lib/enum.ex
@@ -996,8 +996,16 @@ defmodule Enum do
   Similar to `find/3`, but returns the value of the function
   invocation instead of the element itself.
 
+  The return value is considered to be found when the result is truthy
+  (neither `nil` nor `false`).
+
   ## Examples
 
+      iex> Enum.find_value([2, 3, 4], fn x ->
+      ...>   if x > 2, do: x * x
+      ...> end)
+      9
+
       iex> Enum.find_value([2, 4, 6], fn x -> rem(x, 2) == 1 end)
       nil