This function allows you to represent an array, vector, or enumeration of some arbitrary objects as an enumeration of custom elements (see "About Custom Elements" below).

This could be used further to organize iterations by the objects with 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();

Parameter:

a / v / e

The array, vector or enumeration of the objects to be wrapped into custom elements.

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.

Returns:

The enumeration of the custom elements produced from the initial objects.

See Also:

CustomElement(), iterate(), convertEnum()

${include ../../../refs/custom_elements.htm}