<

Array

The SDK makes no use of the STL(Standard Template Library) internally. However, it does contain some functionality that replicates useful sections of the STL.

CIwArray is a templated class that aims to mimic >std::vector. It contains many of the same methods, for example:

• push_back()
• size()
• clear()

CIwArray implements an allocator scheme that dynamically allocates memory as the array grows. It deallocates memory only when destroyed or when the user requests it to do so.

An example of using CIwArray:

CIwArray<uint32> ids;

• ids.push_back(5); // adds the value 5 to the end of the array
• ids.push_back(7); // adds the value 7 to the end of the array
• ids.push_back(2); // adds the value 2 to the end of the array

• uint32 val0 = ids[0]; // gets the value 5
• uint32 val1 = ids[1]; // gets the value 7
• uint32 val2 = ids[2]; // gets the value 2

• uint32 size = ids.size(); // gets the value 3

• ids.clear(); // removes all elements from the array

Note: For an example of how the Array functionality can be used, see the Array Example.