CHStringArray Class

[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 an element (or multiple copies of an element) or all the elements of another array at a specified index.
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)