Module:Set/doc
This is the documentation page for Module:Set
This module is rated as alpha. It is ready for third-party input, and may be used on a few pages to see if problems arise, but should be watched. Suggestions for new features or changes in their input and output mechanisms are welcome. |
This module depends on the following other modules: |
This module includes a number of set operations for Lua tables. It currently has union, intersection and complement functions for both key/value pairs and for values only. It is a meta-module, meant to be called from other Lua modules, and should not be called directly from #invoke.
Loading the module
[mali mi di yibu sheena n-niŋ]To use any of the functions, first you must load the module.
local set = require('Module:Set')
union
[mali mi di yibu sheena n-niŋ]set.union(t1, t2, ...)
Returns the union of the key/value pairs of n tables. If any of the tables contain different values for the same table key, the table value is converted to an array holding all of the different values. For example, for the tables {foo = "foo", bar = "bar"}
and {foo = "foo", bar = "baz", qux = "qux"}
, union will return {foo = "foo", bar = {"bar", "baz"}, qux = "qux"}
. An error is raised if the function receives less than two tables as arguments.
valueUnion
[mali mi di yibu sheena n-niŋ]set.valueUnion(t1, t2, ...)
Returns the union of the values of n tables, as an array. For example, for the tables {1, 3, 4, 5, foo = 7}
and {2, bar = 3, 5, 6}
, valueUnion will return {1, 2, 3, 4, 5, 6, 7}
. An error is raised if the function receives less than two tables as arguments.
intersection
[mali mi di yibu sheena n-niŋ]set.intersection(t1, t2, ...)
Returns the intersection of the key/value pairs of n tables. Both the key and the value must match to be included in the resulting table. For example, for the tables {foo = "foo", bar = "bar"}
and {foo = "foo", bar = "baz", qux = "qux"}
, intersection will return {foo = "foo"}
. An error is raised if the function receives less than two tables as arguments.
valueIntersection
[mali mi di yibu sheena n-niŋ]set.valueIntersection(t1, t2, ...)
Returns the intersection of the values of n tables, as an array. For example, for the tables {1, 3, 4, 5, foo = 7}
and {2, bar = 3, 5, 6}
, valueIntersection will return {3, 5}
. An error is raised if the function receives less than two tables as arguments.
complement
[mali mi di yibu sheena n-niŋ]set.complement(t1, t2, ..., tn)
Returns the relative complement of t1
, t2
, ..., in tn
. The complement is of key/value pairs. This is equivalent to all the key/value pairs that are in tn
but are not in any of t1
, t2
, ... tn-1
. For example, for the tables {foo = "foo", bar = "bar", baz = "baz"}
and {foo = "foo", bar = "baz", qux = "qux"}
, complement would return {bar = "baz", qux = "qux"}
. An error is raised if the function receives less than two tables as arguments.
valueComplement
[mali mi di yibu sheena n-niŋ]set.valueComplement(t1, t2, ..., tn)
This returns an array containing the relative complement of t1
, t2
, ..., in tn
. The complement is of values only. This is equivalent to all the values that are in tn but are not in t1, t2, ... tn-1. For example, for the tables {1, 2}
, {1, 2, 3}
and {1, 2, 3, 4, 5}
, valueComplement would return {4, 5}
. An error is raised if the function receives less than two tables as arguments.