Object PmList (List of values)

Description:

Object represents a list of values.
This object is obsolete (but functional) and it is better to use the PmArray object (items can be added and removed from an PmArray by methods Insert and Remove).

Properties and methods:

GetCount	Returns the number of values present in the list
AddHead	Adds value to the beginning of the list
AddTail	Adds value to the end of the list
GetHead	Returns a value from beginning of the list
GetTail	Returns a value from the end of the list
RemoveHead	Removes value from beginning of the list
RemoveTail	Removes value from the end of the list
SaveToArray	Returns 1-dimensional array of values queue

Note:

- The object can be created by the Pm.CreatePmList method.

- This object is functional also in Web panels.

Values in this object form a list and can be accessed either from beginning (Head) or from the end (Tail) of the list. The values of the list can be:

- added: AddHead, AddTail

- read: GetHead, GetTail

- removed: RemoveHead, RemoveTail

The example of creation and usage of the PmList object:

JavaScriptVBScriptSelect and copy to clipboard



var i;

var oList = Pm.CreatePmList();

oList.AddHead("TitleHead");


for (i = 0; i <= 10; i++)

{

	oList.AddTail("row" + i);

}


// ----------SaveToArray----------

var arr = oList.SaveToArray();


// ----------RemoveHead, RemoveTail----------

var j, nCount;

var sHead = oList.RemoveHead();

Pm.Debug(sHead);


nCount = oList.GetCount();

for (j = nCount; j > 0; j--)

{

	Pm.Debug(oList.RemoveTail());

}