Name
set_by_keywords, tweak_by_keywords — add, replace or remove entries in a keyword/value vector
Synopsis
set_by_keywords(
|
inout arr any, |
| in opcode varchar, | |
| in keyword varchar, | |
| in value any, | |
... ); |
any tweak_by_keywords(
|
in arr any, |
| in opcode varchar, | |
| in keyword varchar, | |
| in value any, | |
... ); |
Description
Virtuoso represents many structured options as keyword vectors of the form
vector ('opt1', val1, 'opt2', val2, ...). These
functions apply a sequence of opcode /
keyword / value triples to
such a vector, replacing, extending, or removing entries by keyword.
set_by_keywords mutates the supplied
arr variable in place.
tweak_by_keywords leaves the input untouched and
returns the modified copy. Recognised opcodes include
'replace', 'extend',
'replace_or_extend', and 'remove';
supplying an unknown opcode raises SQL error 22024 (SR655).