aboutsummaryrefslogtreecommitdiffstats
path: root/lib/stdlib/doc
diff options
context:
space:
mode:
authorJohn Högberg <[email protected]>2018-02-21 12:57:25 +0100
committerJohn Högberg <[email protected]>2018-02-22 10:23:14 +0100
commit8f3536583a6338e3a61dbf008d674f54a77e401c (patch)
treebb8f1a75ff06da9f3fa0515021d6632908e69fae /lib/stdlib/doc
parent1540a0758b8d60af7b3832158015bd8cf64016af (diff)
downloadotp-8f3536583a6338e3a61dbf008d674f54a77e401c.tar.gz
otp-8f3536583a6338e3a61dbf008d674f54a77e401c.tar.bz2
otp-8f3536583a6338e3a61dbf008d674f54a77e401c.zip
Add ets:whereis/1 for resolving table names -> tid()
Diffstat (limited to 'lib/stdlib/doc')
-rw-r--r--lib/stdlib/doc/src/ets.xml20
1 files changed, 20 insertions, 0 deletions
diff --git a/lib/stdlib/doc/src/ets.xml b/lib/stdlib/doc/src/ets.xml
index 1b31a1ec9d..b616e97714 100644
--- a/lib/stdlib/doc/src/ets.xml
+++ b/lib/stdlib/doc/src/ets.xml
@@ -487,6 +487,11 @@ Error: fun containing local Erlang function calls
<p>The pid of the heir of the table, or <c>none</c> if no heir
is set.</p>
</item>
+ <tag><c>{id,</c><seealso marker="#type-tid">
+ <c>tid()</c></seealso><c>}</c></tag>
+ <item>
+ <p>The table identifier.</p>
+ </item>
<tag><c>{keypos, integer() >= 1}</c></tag>
<item>
<p>The key position.</p>
@@ -2037,6 +2042,21 @@ true</pre>
</list>
</desc>
</func>
+
+ <func>
+ <name name="whereis" arity="1"/>
+ <fsummary>Retrieves the tid() of a named table.</fsummary>
+ <desc>
+ <p>This function returns the
+ <seealso marker="#type-tid"><c>tid()</c></seealso> of the named table
+ identified by <c><anno>TableName</anno></c>, or <c>undefined</c> if
+ no such table exists. The <c>tid()</c> can be used in place of the
+ table name in all operations, which is slightly faster since the name
+ does not have to be resolved on each call.</p>
+ <p>If the table is deleted, the <c>tid()</c> will be invalid even if
+ another named table is created with the same name.</p>
+ </desc>
+ </func>
</funcs>
</erlref>