axlSDBSetMultipleEntry

axlSDBSetMultipleEntry(
t_name
)
=> t / nil

Description

Sets a setup database name to be a multiple entry name. By default, a setup database handle is a single entry name. A single-entry element is differentiated only by its name, whereas a multi-entry element is differentiated by both name and value.

Since all children of a particular element must be unique, this means that a single-entry name can only be specified at most once whereas a multi-entry name can have siblings having the same name. Some examples of built-in multiple entry names in ADE include var, corner, or test.

The table containing names specified to be multi-entry is shared across all ADE sessions in the same virtuoso process, and therefore no session or setup database handle is necessary. The list of multi-entry names will be written upon setup database save and restored upon load; it is not necessary to call axlSDBSetMultipleEntry() at each session invocation.

Arguments

t_name

Name of the element to be set as multi-entry. Following are the naming conventions:

Must start with an uppercase letter
Can contain letters, digits, underscores, hyphens, and periods
Cannot contain whitespace

Names beginning with lowercase letters are reserved for future ADE expansion.

Value Returned

`t`	The setup database handle is set as a multi-entry element.
`nil`	The setup database handle is not set as a multi-entry element.

Examples

Sets the setup database Ministers as a multiple entry name.

axlSDBSetMultipleEntry("Ministers")
=> t

Return to top

Virtuoso ADE SKILL ReferenceProduct Version IC23.1, November 2023