aboutsummaryrefslogtreecommitdiff
path: root/man/man3/tomo-Table.without.3
diff options
context:
space:
mode:
authorBruce Hill <bruce@bruce-hill.com>2025-09-21 23:06:14 -0400
committerBruce Hill <bruce@bruce-hill.com>2025-09-21 23:06:14 -0400
commitbf067544e98f4085c26161953e301aaa00a904df (patch)
treee0b4d0c54c6a6c76e55c233cc40a19e96b5375d0 /man/man3/tomo-Table.without.3
parent0d36812c6af951a41caac77d5f312949f3bc521f (diff)
Update docs
Diffstat (limited to 'man/man3/tomo-Table.without.3')
-rw-r--r--man/man3/tomo-Table.without.338
1 files changed, 38 insertions, 0 deletions
diff --git a/man/man3/tomo-Table.without.3 b/man/man3/tomo-Table.without.3
new file mode 100644
index 00000000..7244dac6
--- /dev/null
+++ b/man/man3/tomo-Table.without.3
@@ -0,0 +1,38 @@
+'\" t
+.\" Copyright (c) 2025 Bruce Hill
+.\" All rights reserved.
+.\"
+.TH Table.without 3 2025-09-21 "Tomo man-pages"
+.SH NAME
+Table.without \- return a table without key/value pairs in another table
+.SH LIBRARY
+Tomo Standard Library
+.SH SYNOPSIS
+.nf
+.BI Table.without\ :\ func(t:\ {K:V},\ other:\ {K:V}\ ->\ {K:V})
+.fi
+.SH DESCRIPTION
+Return a copy of a table, but without any of the exact key/value pairs found in the other table.
+
+
+.SH ARGUMENTS
+
+.TS
+allbox;
+lb lb lbx lb
+l l l l.
+Name Type Description Default
+t {K:V} The base table. -
+other {K:V} The other table whose key/value pairs will be omitted. -
+.TE
+.SH RETURN
+The original table, but without the key/value pairs from the other table.
+
+.SH NOTES
+Only exact key/value pairs will be discarded. Keys with a non-matching value will be kept.
+
+.SH EXAMPLES
+.EX
+t := {"A": 1; "B": 2, "C": 3}
+assert t.without({"B": 2, "C": 30, "D": 40}) == {"A": 1, "C": 3}
+.EE