[ ] | The bracket operator can be used to get and set array elements. |
append Statement
| appends elements to arrays. |
apply Statement
| applies E2E Action Language operations to array elements. |
buildMap()
| builds a map from an array. |
concatArrays()
| concatenates the elements of one or more arrays to a target array. |
count()
| counts the number of elements in an array. |
getMapEntries()
| gets all map entries to an array (see chapter Map Operations). |
join()
| concatenates all strings of an array of strings and separates them a separator. |
reduce Statement
| reduces array valued types to scalars. |
select Statement
| filters array items by evaluating a boolean expression for each array element using an SQL like syntax. |
sort Statement
| sorts array elements in defined order. |
The following pages describe the above operations in more detail. More information about arrays can be found in section Base Types.
Creating Arrays
You can create arrays using the However, most of the time the E2E Runtime will create the array implicitly on appending the first item. There is one exception to this rule, though: Arrays that contain array elements having a complex type with multiplicity. What you can do, if The reference What you can't do, if In this case (get statement on the right side of a statement), the Runtime will throw a get error for create
statement (see action script example below):create anArray;
append "Hello World!" to anArray;
Let's assume you have an array of complex type ArrayElement and this complex type has a property subArray
with multiplicity 0..*.subArray
is NULL
:set array1[0].subArray = anotherArray;
subArray
is changed to point to anotherArray
.subArray
is NULL:
append "something" to array1[0].subArray;
array1[0].subArray
.
Some Array How-tos
Find below a list of some useful code snippets in array context:
Task | Code Snippet | Descriptions |
---|---|---|
empty array | set array = select each from array where false; | A new array is created containing all references to elements of
|
set array = NULL; | The reference of In the UML model, you will have now a non-existent array. You can append items using the append Statement statement, the array will implicitly be created, then. | |
copy all content from array1 to array2 | set array2 = select each from array1 where true; | A new array is created containing all references to elements of In the UML model you will now see two arrays |
set array2 = array1.copy(); | A new array is created that contains a true deep copy of all elements of In the UML model you will now see two arrays | |
append all content from array1 to array2 | set array2 = array2.concatArrays(array1) | A new array is created containing all references to elements of In the UML model you will now see an array |