File 0565-Clarify-the-Pred-function-in-lists-must-re... of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 0565-Clarify-the-Pred-function-in-lists-must-return-boole.patch of Package erlang (Revision 38489c07175b7fbd451db8f53462a958)

Currently displaying revision 38489c07175b7fbd451db8f53462a958 , Show latest

From dd4f76152077ade499a51c02b8b56403d90264b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jos=C3=A9=20Valim?= <jose.valim@dashbit.co>
Date: Sat, 19 Jun 2021 17:00:39 +0200
Subject: [PATCH] Clarify the Pred function in lists must return booleans

Closes #4985.
---
 lib/stdlib/doc/src/lists.xml | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/lib/stdlib/doc/src/lists.xml b/lib/stdlib/doc/src/lists.xml
index 9261ade998..5477f13d1e 100644
--- a/lib/stdlib/doc/src/lists.xml
+++ b/lib/stdlib/doc/src/lists.xml
@@ -69,7 +69,8 @@
 <desc>
 Returns <c>true</c> if <c><anno>Pred</anno>(<anno>Elem</anno>)</c>
 returns <c>true</c> for all elements <c><anno>Elem</anno></c> in
- <c><anno>List</anno></c>, otherwise <c>false</c>.
+ <c><anno>List</anno></c>, otherwise <c>false</c>. The <c>Pred</c>
+ function must return a boolean.
 </desc>
 </func>
 
@@ -80,7 +81,8 @@
 <desc>
 Returns <c>true</c> if <c><anno>Pred</anno>(<anno>Elem</anno>)</c>
 returns <c>true</c> for at least one element <c><anno>Elem</anno></c>
- in <c><anno>List</anno></c>.
+ in <c><anno>List</anno></c>. The <c>Pred</c> function must return a
+ boolean.
 </desc>
 </func>
 
@@ -154,7 +156,8 @@
 Drops elements <c><anno>Elem</anno></c> from
 <c><anno>List1</anno></c> while
 <c><anno>Pred</anno>(<anno>Elem</anno>)</c> returns <c>true</c> and
- returns the remaining list.
+ returns the remaining list. The <c>Pred</c> function must return a
+ boolean.
 </desc>
 </func>
 
@@ -177,7 +180,8 @@
 <desc>
 <c><anno>List2</anno></c> is a list of all elements
 <c><anno>Elem</anno></c> in <c><anno>List1</anno></c> for which
- <c><anno>Pred</anno>(<anno>Elem</anno>)</c> returns <c>true</c>.
+ <c><anno>Pred</anno>(<anno>Elem</anno>)</c> returns <c>true</c>.
+	 The <c>Pred</c> function must return a boolean.
 </desc>
 </func>
 
@@ -696,7 +700,8 @@ c</pre>
 such that <c><anno>Pred</anno>(<anno>Value</anno>)</c> returns
 <c>true</c>, returns <c>{value, <anno>Value</anno>}</c>
 for the first such <c><anno>Value</anno></c>,
- otherwise returns <c>false</c>.
+ otherwise returns <c>false</c>. The <c>Pred</c> function must return
+ a boolean.
 </desc>
 </func>
 
@@ -798,7 +803,8 @@ splitwith(Pred, List) ->
 {[1],[2,3,4,5,6,7]}
 > <input>lists:splitwith(fun(A) -> is_atom(A) end, [a,b,1,c,d,2,3,4,e]).</input>
 {[a,b],[1,c,d,2,3,4,e]}</pre>
- For a different way to partition a list, see 
+ The <c>Pred</c> function must return a
+ boolean. For a different way to partition a list, see 
 <seemfa marker="#partition/2"><c>partition/2</c></seemfa>.
 </desc>
 </func>
@@ -879,7 +885,8 @@ splitwith(Pred, List) ->
 <c><anno>List1</anno></c> while
 <c><anno>Pred</anno>(<anno>Elem</anno>)</c> returns <c>true</c>, that
 is, the function returns the longest prefix of the list for which
- all elements satisfy the predicate.
+ all elements satisfy the predicate. The <c>Pred</c> function must
+ return a boolean.
 </desc>
 </func>
 
-- 
2.26.2

Places

File 0565-Clarify-the-Pred-function-in-lists-must-return-boole.patch of Package erlang (Revision 38489c07175b7fbd451db8f53462a958)

Places