VirtualStringArray Object

The VirtualStringArray object provides properties and methods for expressions that evaluate to a StringArray. One example of an expression that evaluates to a StringArray is StringArray.Reverse().

Users cannot create instances of this type of object. However, users can access instances of this object type that have been created indirectly, for example as children of other objects. Users can also access any static properties and methods on this object type.

Available In Editions:

Timing Precision Mode

Name

Description

Attributes

Count

The number of elements in the array.

Type: Variable

Access: Read-Only

Name	Description
BuildSingleString	Returns a concatenation of the elements of the StringArray, delimited by the user-specified character sequence.
Find	Returns the position of the specified string (or character) in the calling String, or the number of matches in the calling StringArray.
FindAll	Finds all indices at which the specified value is present.
FindFirst	Finds the first index at which the specified value is present. If the value is not present in the array, -1 will be returned.
FindLast	Finds the last index at which the specified value is present. If the value is not present in the array, -1 will be returned.
GetShuffledElements	Returns a copy of the calling StringArray where the elements have been randomly shuffled. Calling SeedNoise will set the seed for this method.
GetUniqueElements	Returns a StringArray containing the unique elements of the calling StringArray in the order in which they appeared in the calling StringArray.
IFind	Returns the position of the specified string (or character) in the calling String, or the number of matches in the calling StringArray, ignoring case.
IsEqualTo	Determines if two arrays are equal.
Reversed	Returns a copy of the StringArray with the elements in reverse order.
SortedAscending	Returns a copy of the calling StringArray sorted in ascending order.
SortedDescending	Returns a copy of the calling StringArray sorted in descending order.
ToArray	Converts the StringArray to a normal Array with Variable values.
WriteToFile	Writes the contents of a StringArray to a file. Each Element becomes a new line in the file.