A list collection represents a list of data type elements, each of which is associated with a numeric position in the list. More...

Inheritance diagram for AbstractListOfDT:

[legend]

Collaboration diagram for AbstractListOfDT:

[legend]

Public Member Functions
_.Library.String	Find (_.Library.String element, _.Library.Integer key)
	A list collection represents a list of data type elements, each of which is associated with a numeric position in the list. More...

_.Library.String	GetAt (_.Library.Integer key)
	Finds and returns the value of the element at position. More...

_.Library.String	GetNext (_.Library.Integer key)
	Finds and returns the value of the element at the position after key More...

_.Library.String	GetPrevious (_.Library.Integer key)
	Finds and returns the value of the element at the position before key More...

_.Library.Status	Insert (_.Library.String element)
	Inserts an element with value element at the end of the list. More...

_.Library.Status	InsertAt (_.Library.String element, _.Library.Integer key)
	Inserts an element with value element at position key. More...

_.Library.Status	InsertList (_.Library.String inslist)
	Inserts a list with value inslist at the end of the list. More...

_.Library.Status	InsertOrdered (_.Library.String element)
	Inserts an element with value element into the list at the correct ordered. More...

_.Library.String	RemoveAt (_.Library.Integer key)
	Removes the element at position key in the list. More...

_.Library.Status	SetAt (_.Library.String element, _.Library.Integer key)
	Sets the value of the element at position key to element. More...

Public Member Functions inherited from AbstractList
_.Library.Status	Clear ()
	Clears the contents of the list. More...

_.Library.Integer	Count ()
	Returns the number of elements contained in the list.

_.Library.String	Find (_.Library.RawString element, _.Library.Integer key)
	Starting from, but not including, position key, Find finds. More...

_.Library.Status	Insert (_.Library.RawString element)
	Inserts an element with value element at the end of the list. More...

_.Library.Status	InsertAt (_.Library.RawString element, _.Library.Integer key)
	Inserts an element with value element at position key. More...

_.Library.Status	InsertList (_.Library.RawString inslist)
	Inserts a list with value inslist at the end of the list. More...

_.Library.Status	InsertOrdered (_.Library.RawString element)
	Inserts an element with value element into the list at the correct ordered. More...

_.Library.Integer	Next (_.Library.Integer key)
	Finds and returns the index value of the element at the location following key in the list. More...

_.Library.Integer	Previous (_.Library.Integer key)
	Finds and returns the index value of the element at the location preceding key in the list. More...

_.Library.Status	SetAt (_.Library.RawString element, _.Library.Integer key)
	Sets the value of the element at position key to element. More...

Public Member Functions inherited from AbstractIterator
_.Library.RawString	GetAt (_.Library.RawString key)
	Definition of iterator methods that all our collections classes use to ensure consistency. More...

_.Library.RawString	GetNext (_.Library.RawString key)
	Finds and returns the value of the element at the location after key More...

_.Library.RawString	Next (_.Library.RawString key)
	Finds and returns the key value of the element at the location following key in the iteration. More...

Additional Inherited Members
Static Public Member Functions inherited from AbstractList
_.Library.Status	BuildValueArray (_.Library.Binary serialized, _.Library.Binary array)
	Constructs array(key)=value for each element in the serialval value. More...

_.Library.String	LogicalToOdbc (_.Library.String val, _.Library.String delim, _.Library.String class, _.Library.String method)
	Converts the serial state of this list object to a delimited string. More...

_.Library.String	OdbcToLogical (_.Library.String val, _.Library.String delim, _.Library.String class, _.Library.String method)
	Converts the value of an incoming delimited string to a serialized state. More...

Detailed Description

A list collection represents a list of data type elements, each of which is associated with a numeric position in the list.

The first element in the list is stored at position 1.

The <CLASS>Collection.AbstractList</CLASS> class provides the basic functionality of the
various list collection classes.

The non-abstract list classes derived from <CLASS>AbstractList</CLASS> include <CLASS>ListOfDataTypes</CLASS>, <CLASS>ListOfObjects</CLASS>, <CLASS>Collection.ListOfObj</CLASS> and <CLASS>Collection.ListOfDT</CLASS>.

You can use a list object as follows:

Set list=##class(ListOfDataTypes).New()

; add items to the list Do list.Insert("Harpo") Do list.Insert("Groucho") Do list.Insert("Chico") Do list.Insert("Karl")

; iterate over contents of list For i=1:1:list.Count() Write list.GetAt(i),!

Member Function Documentation

◆ Find()

_.Library.String Find	(	_.Library.String	element,
		_.Library.Integer	key
	)

A list collection represents a list of data type elements, each of which is associated with a numeric position in the list.

The first element in the list is stored at position 1.

The <CLASS>Collection.AbstractList</CLASS> class provides the basic functionality of the
various list collection classes.

The non-abstract list classes derived from <CLASS>AbstractList</CLASS> include <CLASS>ListOfDataTypes</CLASS>, <CLASS>ListOfObjects</CLASS>, <CLASS>Collection.ListOfObj</CLASS> and <CLASS>Collection.ListOfDT</CLASS>.

You can use a list object as follows:

Set list=##class(ListOfDataTypes).New()

; add items to the list Do list.Insert("Harpo") Do list.Insert("Groucho") Do list.Insert("Chico") Do list.Insert("Karl")

; iterate over contents of list For i=1:1:list.Count() Write list.GetAt(i),!

Starting from, but not including, position key, Find finds

the next element in the list with value equal to element. If key is a null string, Find starts at the beginning of the list.

Find returns the position of the found element or null string ("") if no element was found.

Reimplemented in ListOfDT.

◆ GetAt()

_.Library.String GetAt ( _.Library.Integer key )

Finds and returns the value of the element at position.

key in the list.

GetAt returns the value of the element at location key or null string ("") if no element is found.

Reimplemented from AbstractList.

Reimplemented in ListOfDT.

◆ GetNext()

_.Library.String GetNext ( _.Library.Integer key )

Finds and returns the value of the element at the position after key

in the list. If key is a null string (""), it returns the value of the first element in the list.

The value of key, which is passed by reference, is updated to the position value of the returned element or null string ("") if key is at the end of the list.

Reimplemented from AbstractList.

Reimplemented in ListOfDT.

◆ GetPrevious()

_.Library.String GetPrevious ( _.Library.Integer key )

Finds and returns the value of the element at the position before key

in the list. If key is a null string (""), it returns the value of the last element in the list.

The value of key, which is passed by reference, is updated to the position value of the returned element or null string ("") if key is at the beginning of the list.

Reimplemented from AbstractList.

Reimplemented in ListOfDT.

◆ Insert()

_.Library.Status Insert ( _.Library.String element )

Inserts an element with value element at the end of the list.

<p>Returns a <CLASS>%Status</CLASS> value indicating success or failure.

Reimplemented in ListOfDT.

◆ InsertAt()

_.Library.Status InsertAt	(	_.Library.String	element,
		_.Library.Integer	key
	)

Inserts an element with value element at position key.

<p>To make room for the new element, the elements previously at or following position 
<var>key</var> are moved up by one position.
<p><var>key</var> must be in the following range: 
<blockquote><code>
1 &lt= key &lt= Count() + 1
</blockquote></code>

Returns a <CLASS>%Status</CLASS> value indicating success or failure.

Reimplemented in ListOfDT.

◆ InsertList()

_.Library.Status InsertList ( _.Library.String inslist )

Inserts a list with value inslist at the end of the list.

<p>Returns a <CLASS>%Status</CLASS> value indicating success or failure.

Reimplemented in ListOfDT, and ListOfDT.

◆ InsertOrdered()

_.Library.Status InsertOrdered ( _.Library.String element )

Inserts an element with value element into the list at the correct ordered.

position. The elements in the list are shifted to accommodate the new element as necessary.

Returns a <CLASS>Status</CLASS> value indicating success or failure.

Reimplemented in ListOfDT.

◆ RemoveAt()

_.Library.String RemoveAt ( _.Library.Integer key )

Removes the element at position key in the list.

The elements following position key are moved to fill in the resulting gap.

RemoveAt returns the value of the removed element or null string ("") if no element was removed.

Reimplemented from AbstractList.

Reimplemented in ListOfDT.

◆ SetAt()

_.Library.Status SetAt	(	_.Library.String	element,
		_.Library.Integer	key
	)

Sets the value of the element at position key to element.

Returns a <CLASS>Status</CLASS> value indicating success or failure.

Reimplemented in ListOfDT.

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ Find()

◆ GetAt()

◆ GetNext()

◆ GetPrevious()

◆ Insert()

◆ InsertAt()

◆ InsertList()

◆ InsertOrdered()

◆ RemoveAt()

◆ SetAt()