Applies a formula to each element of a list and returns the results in a list.

Note This @function is new with Release 6.

Syntax

@Transform( list ; variableName ; formula )

Parameters

list

Text, number, or time-date list. The list to be acted upon.

Text. The name of a variable. Use this variable in the formula to refer to the list element being acted upon.

Valid formula that evaluates to a result. The remainder of @Transform after the second parameter is the formula that is applied to each element of the input list. The formula must return a value.

list

Text, number, or time-date. The result of the transformation on the input list. The first value returned by the formula determines the data type of the list. Subsequent return values must be of the same type.

An iteration of the formula can return a list, which adds multiple values to the return list.

@Transform returns an error if any iteration of the formula returns an error.

If an iteration of the formula returns @Nothing, no element is added to the return list.

Language cross-reference

ForAll statement of LotusScript language

Example
See Also

Working with lists
"Enhancements to the formula language in Rnext" on the Lotus Developer Domain

Glossary