Promotic

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:
GetCountReturns the number of values present in the list
AddHeadAdds value to the beginning of the list
AddTailAdds value to the end of the list
GetHeadReturns a value from beginning of the list
GetTailReturns a value from the end of the list
RemoveHeadRemoves value from beginning of the list
RemoveTailRemoves value from the end of the list
SaveToArrayReturns 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
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());
}

History:
Pm9.00.04: This object is considered to be obsolete and replaced by the PmArray object with methods Insert and Remove.
Pm8.03.08: Allows the application designer to create a LIFO and FIFO list of values in this object.
PROMOTIC 9.0.21 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
© MICROSYS, spol. s r. o.