CHStringArray class (chstrarr.h)
[The CHStringArray class is part of the WMI Provider Framework which is now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.]
The following table lists the CHStringArray methods and operators.
CHStringArray has these types of members:
Constructors
The CHStringArray class has these constructors.Constructor | Description |
---|---|
CHStringArray | Constructs an empty array for CHString objects. |
Methods
The CHStringArray class has these methods.Method | Description |
---|---|
Add | Adds an element to the end of the array; the array grows if necessary. |
Append | Appends another array to the array; the array grows if necessary. |
Copy | Copies another array to the array; the array grows if necessary. |
ElementAt | Returns a temporary reference to the element pointer within the array. |
FreeExtra | Frees all unused memory above the current upper bound. |
GetAt | Returns the value at a given index. |
GetData | Allows access to elements in the array. The value can be NULL. |
GetSize | Gets the number of elements in the array. |
GetUpperBound | Returns the largest valid index. |
InsertAt | Overloaded. Inserts an element (or all of the elements in another array) at a specified index. |
Operator [] | Sets or gets the element at the specified index. |
RemoveAll | Removes all of the elements from this array. |
RemoveAt | Removes an element at a specific index. |
SetAt | Sets the value for a given index; the array is not allowed to grow. |
SetAtGrow | Sets the value for a given index; the array grows if necessary. |
SetSize | Sets the number of elements to be contained in this array |
Methods
The CHStringArray class has these methods.
Method | Description |
---|---|
CHStringArray::Add | The Add method adds a new element to the end of an array, increasing the array by one. |
CHStringArray::Append | The Append method adds the contents of another array to the end of the given array. |
CHStringArray::CHStringArray | The CHStringArray constructor constructs an empty CHStringArray array. |
CHStringArray::Copy | The Copy method overwrites the elements of the given array with the elements of another array. |
CHStringArray::ElementAt | The ElementAt method returns a temporary reference to the element pointer within the array. |
CHStringArray::ElementAt | The ElementAt method returns a temporary reference to the element pointer within the array. |
CHStringArray::FreeExtra | The FreeExtra method frees any extra memory allocated while the array increased. This method has no effect on the size or upper bound of the array. |
CHStringArray::GetAt | Gets the array element at the specified index. |
CHStringArray::GetData | The GetData method gains direct access to the elements in the array. |
CHStringArray::GetSize | The GetSize method gets the size of the array. Because indexes are zero-based, the size is one greater than the largest index. |
CHStringArray::GetUpperBound | The GetUpperBound method gets the current upper bound of an array. Because array indexes are zero-based, this function returns a value that is one less than GetSize. |
CHStringArray::InsertAt | The InsertAt method inserts all of the elements of another CHStringArray array at the index specified by nStartIndex. |
CHStringArray::InsertAt | The InsertAt method inserts an element (or multiple copies of an element) or all the elements of another array at a specified index. |
CHStringArray::RemoveAll | The RemoveAll method removes all the CHString members from this array. |
CHStringArray::RemoveAt | The RemoveAt method removes one or more elements starting at a specified index in an array. |
CHStringArray::SetAt | The SetAt method sets the array element at the specified index. |
CHStringArray::SetAt | The SetAt method sets the array element at the specified index. |
CHStringArray::SetAtGrow | Sets the array element at the specified index. |
CHStringArray::SetSize | The SetSize method establishes the size of an empty or existing array. |
Requirements
Minimum supported client | Windows Vista |
Minimum supported server | Windows Server 2008 |
Target Platform | Windows |
Header | chstrarr.h (include FwCommon.h) |