This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRISOpens in a new window, see the InterSystems IRIS Adoption Guide and the InterSystems IRIS In-Place Conversion Guide, both available on the WRC Distributions pageOpens in a new window (login required).

Caché & Ensemble 2018.1.5Opens in a new window > Class Reference > %SYS namespace > %Library.List


datatype class %Library.List


The %List data type class is used to represent data that is in $List format. The logical value for %List is a list of elements in $List format.

When a %List data type value is projected to a client application, it exposes it as a Caché syslist object. This allows the client application to efficiently manipulate the contents of the list.

Note that $List format is a compressed binary format; for this reason, a property of type of %List cannot be set through SQL nor can its value be queried through SQL (such as with a WHERE clause).

Refer to the documentation on $List in the Caché ObjectScript Reference Manual for more information.

Method Inventory (Including Private)


parameter ODBCDELIMITER = ,;
A %List value is converted to a delimited string when it is projected via ODBC. ODBCDELIMITER is the delimiter character used to construct the delimited string.
parameter XSDTYPE = string;
Declares the XSD type used when projecting XML Schemas.

Methods (Including Private)

classmethod LogicalToOdbc(val="") as %String
Converts the value of this data type from $List format to a delimited string using the value of the ODBCDELIMITER parameter as a delimiter.
classmethod LogicalToXSD(val As %List) as %String
Converts the Cache $list value to the canonical SOAP encoded value.
classmethod OdbcToLogical(val="") as %String
Converts the value of an incoming delimited string to $List format using the value of the ODBCDELIMITER parameter as a delimiter.
classmethod XSDToLogical(val As %String) as %List
Converts the SOAP encoded input list value into a Cache $list value.


FeedbackOpens in a new window