PointList

Description: This function returns an array of tag names within the current scope, given the name of a tag type or group.

Returns: Array

Usage: Script

Format: \PointList(TagType[, SearchString, NoFilterSimulation])

Parameters: TagType { text } { required } { no default: }

Any text expression giving a type of tag or the name of a tag group.

SearchString { text } { optional } { default: “*” }

Any text value. The search will be limited to tags with matching names. May include wildcards.

NoFilterSimulation { Boolean } { optional } { default: False }

If set TRUE, tags in the simulation area will not be filtered out of the selection.

Comments: This utility function reduces the effort required to obtain a list of tags of a particular type or group membership. If no matching tags are found, the first element of the array will be Invalid.

A similar (but very slightly different) function also exists as part of VTScada. Use care to be sure which version of the function you are calling.

Examples:

{ Get a list of the Stations }

Stations = \PointList("VTScadaDriver", "*", 0);

NStations = ArraySize(Stations, 0);