deprecate contains(eq, itr, item)

NEWS.md

@@ -443,6 +443,8 @@ Deprecated or removed
     this is not true. If you are certain you need the old behavior, it is temporarily available
     as `Base._isleaftype` ([#17086]).
 
+  * `contains(eq, itr, item)` is deprecated in favor of `any` with a predicate ([#23716]).
+
 Command-line option changes
 ---------------------------
 

base/deprecated.jl

@@ -1806,6 +1806,8 @@ import .Iterators.enumerate
     return p
 end
 
+@deprecate contains(eq::Function, itr, x) any(y->eq(y,x), itr)
+
 # END 0.7 deprecations
 
 # BEGIN 1.0 deprecations

base/reduce.jl

@@ -637,38 +637,6 @@ const ∈ = in
 ∋(itr, x)= ∈(x, itr)
 ∌(itr, x)=!∋(itr, x)
 
-"""
-    contains(fun, itr, x) -> Bool
-
-Returns `true` if there is at least one element `y` in `itr` such that `fun(y,x)` is `true`.
-
-```jldoctest
-julia> vec = [10, 100, 200]
-3-element Array{Int64,1}:
-  10
- 100
- 200
-
-julia> contains(==, vec, 200)
-true
-
-julia> contains(==, vec, 300)
-false
-
-julia> contains(>, vec, 100)
-true
-
-julia> contains(>, vec, 200)
-false
-```
-"""
-function contains(eq::Function, itr, x)
-    for y in itr
-        eq(y, x) && return true
-    end
-    return false
-end
-
 
 ## count
 

doc/src/stdlib/arrays.md

@@ -106,7 +106,6 @@ Base.flipdim
 Base.circshift
 Base.circshift!
 Base.circcopy!
-Base.contains(::Function, ::Any, ::Any)
 Base.find(::Any)
 Base.find(::Function, ::Any)
 Base.findn

test/reduce.jl

@@ -370,7 +370,7 @@ A = reshape(map(UInt8, 1:100), (10,10))
 let A = collect(1:10)
     @test A ∋ 5
     @test A ∌ 11
-    @test contains(==,A,6)
+    @test any(y->y==6,A)
 end
 
 # issue #18695