keyval() Function

Function

keyval( text, keys, separators, delimiters )

Returns the value(s) associated with the given key(s). This function performs the reverse of insertkeyval() function.

See also: insertkeyval()

Parameters

Keyword Type Description

text

Text

The text to parse.

keys

Text Array

Array of keys.

separators

Text Array

Array of key-value separators.

delimiters

Text Array

Array of delimiters specifying the end of a value.

Returns

Text Array

Usage considerations

Using the separators parameter

If a single separator value is passed, it is used for parsing all key-value pairs; if multiple separators are specified, the number of separators must match the number of keys.

Using the delimiter parameter

If a single delimiter value is passed, it is used for parsing all key-value pairs; if multiple delimiters are specified, the number of delimiters must match the number of keys.

Examples

You can experiment with this function in the test box below.

Test Input

keyval("hello=alpha][goodbye=beta]", {"hello"}, "=", "]") returns alpha

Open in Github Built: Thu, Oct 14, 2021 (02:44:31 PM)

On This Page

FEEDBACK