View Source

Cleans an array by removing blank elements and/or removing duplicates.

NewArray = SRP_Array("Clean", Array, Option, Delim)

Returns

The cleaned array.

Parameters

Parameter	Description
Array	The dynamic array to be cleaned. (REQUIRED)
Option	Determines the kind of clean operation to perform. (OPTIONAL)
Delim	The delimiter that separates the elements in the given Array. (OPTIONAL)

Remarks

Need to tidy up your array? Use the Clean service to quickly remove blanks and duplicates from your dynamic array. Simply pass it your array and its delimiter. You can use the Option parameter to control the cleaning process.

To remove duplicates in addition to removing blanks, set the Option parameter to "TrimAndMakeUnique".
To remove only trailing blanks, set the Option parameter to "TrimTrailing". Doing so will leave blanks inside the array and only remove blanks at the end of the array.
Omitting the Option parameter or setting it to "Trim" will simply remove all blanks, including trailing blanks.

The Delim paramater can also be omitted, in which case it will assume @FM.

Note: This only operates at a 1-dimensional level. This will not work as expected with 2-dimensional data returned from controls like the EDITTABLE.

Examples

// Remove blanks
Array = "Don":@FM:@FM:@FM:"Don":@FM:@FM:@FM:"Paul":@FM:@FM:@FM:"Frank":@FM:@FM:@FM:"Bob":@FM:@FM:@FM
NewArray = SRP_Array("Clean", Array)
// NewArray will be "Don":@FM:"Don":@FM:"Paul":@FM:"Frank":@FM:"Bob"

// Remove all blanks using custom delimiter
Array = "Don~~Don~~Paul~~Frank~~Bob~~"
NewArray = SRP_Array("Clean", Array, "Trim", "~")
// NewArray will be "Don~Don~Paul~Frank~Bob"

// Remove blanks and duplicates
Array = "Don~~Don~~Paul~~Frank~~Bob~~"
NewArray = SRP_Array("Clean", Array, "TrimAndMakeUnique", "~")
// NewArray will be "Don~Paul~Frank~Bob"

// Remove only trailing blanks
Array = "Don":@FM:@FM:@FM:"Don":@FM:@FM:@FM:"Paul":@FM:@FM:@FM:"Frank":@FM:@FM:@FM:"Bob":@FM:@FM:@FM
NewArray = SRP_Array("Clean", Array, "TrimTrailing", @FM)
// NewArray will be "Don":@FM:@FM:@FM:"Don":@FM:@FM:@FM:"Paul":@FM:@FM:@FM:"Frank":@FM:@FM:@FM:"Bob"