Allows you to represent an array, vector, or enumeration of some arbitrary objects as an enumeration of custom elements.
This could be used to organize iterations by such objects using an Element Iterator or any other element-specific functionality.
The function creates a custom element by each object contained in the specified array/vector/enumeration so that the element's value is assigned with that object. The new elements are returned via an enumeration in the same order as the objects in the initial array/vector/enumeration.
Essentially, the function does the same as the following expression:
v = Vector();
iterate (
a, // or 'v' or 'e'
@obj,
FlexQuery (
v.addElement (CustomElement (obj))
)
);
v.toEnum();
a / v / e
The specified array/vector/enumeration may also include null
objects,
which will be represented as custom elements with null
value.
When this parameter itself is null
, the function will return an empty enumeration.
CustomElement(), iterate(), convertEnum()