Arrays

ATL Server supports two kinds of arrays: fixed- size arrays (which includes multidimensional) and variable-length arrays. In terms of the SOAP request processing and response generation, there s relatively little difference between these two types of arrays, except that with fixed-size arrays, a specific number of elements is expected and if the number of elements received exceeds or falls below this number, an error will be returned by the framework. With variable-length arrays, the array elements are allocated as necessary.

When an array element is encountered , the framework will push an array state onto the stack in much the same way it handles structs. The pvElement field of the new state will point to the base of the array, and each element that s encountered from this point on will be incremented off pvElement based on the ordinal of the element (the nElement field of the ParseState is incremented for each array entry encountered) and the size of the data being stored in the array. The rest of the processing continues as normal for the actual data in the array, which may contain structs that contain arrays and so forth.