From 5b7e50500f6cb3e680b277f871392ac706c5c1d7 Mon Sep 17 00:00:00 2001
From: Guilherme Andrade <g@gandrade.net>
Date: Fri, 3 Jun 2016 00:39:01 +0100
Subject: ETS: Allow for matchspec-based replacement

---
 lib/stdlib/doc/src/ets.xml | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

(limited to 'lib/stdlib/doc')

diff --git a/lib/stdlib/doc/src/ets.xml b/lib/stdlib/doc/src/ets.xml
index 05401a2d40..36c803b40c 100644
--- a/lib/stdlib/doc/src/ets.xml
+++ b/lib/stdlib/doc/src/ets.xml
@@ -1490,6 +1490,27 @@ is_integer(X), is_integer(Y), X + Y < 4711]]></code>
       </desc>
     </func>
 
+    <func>
+      <name name="select_replace" arity="2"/>
+      <fsummary>Match the objects in an ETS table against a match_spec and
+        replaces matching objects with the match_spec result</fsummary>
+      <desc>
+        <p>Matches the objects in the table <c><anno>Tab</anno></c> using a
+          <seealso marker="#match_spec">match_spec</seealso>. If the
+          an object is matched, and the match_spec result is an object with the
+          same key, the existing object is replaced with the match_spec result.
+          For any other result from the match_spec the object is kept
+          unchanged.</p>
+        <p>The function returns the number of objects actually
+          replaced in the table.</p>
+        <note>
+          <p>The <c>match_spec</c> has to return an object with the same key if
+            the object is to be replaced. No other return value will get the
+            object replaced.</p>
+        </note>
+      </desc>
+    </func>
+
     <func>
       <name name="select_reverse" arity="1"/>
       <fsummary>Continue matching objects in an ETS table.</fsummary>
-- 
cgit v1.2.3