(Quick Reference)
Purpose
Delete a
Smartionary
and its
SmartionaryEntry
associates, or delete one
or more
SmartionaryEntry
associates from a
Smartionary
.
Examples
Smartionary.delete('fruits')
Smartionary.delete('fruits', 'a')
Smartionary.delete('fruits', 'a, 'b', 'd')
Description
When given the
key
or
keys
parameter,
delete()
will only remove the
specified
SmartionaryEntry
associates whose
key
field matches. If only
the
smartionaryName
is passed, it will delete all
SmartionaryEntry
associates from the
Smartionary
, and then delete the
Smartionary
.
If any
key
does not exist, or if there is no
Smartionary
with the presented
smartionaryName
, then nothing is done (
null design pattern).
For quickly deleting all
SmartionaryEntry
associates, see
purge.
For quickly deleting
SmartionaryEntry
associates whose
value
is
null
,
see
purgeNull.