Method Reserve

Include/XnArray.h:107–138

Reserves space in this array for the specified number of elements. This saves you re-allocations and data copies if you know the size in advance. **/

	/** Reserves space in this array for the specified number of elements. 
	    This saves you re-allocations and data copies if you know the size in advance. **/
	XnStatus Reserve(XnUInt32 nReservedSize)
	{
		if (nReservedSize > m_nAllocatedSize)
		{
			//Calculate next power of 2 after nReservedSize
			nReservedSize--;
			nReservedSize = (nReservedSize >> 1) | nReservedSize;
			nReservedSize = (nReservedSize >> 2) | nReservedSize;
			nReservedSize = (nReservedSize >> 4) | nReservedSize;
			nReservedSize = (nReservedSize >> 8) | nReservedSize;
			nReservedSize = (nReservedSize >> 16) | nReservedSize;
			nReservedSize++; // nReservedSize is now the next power of 2.

			//Allocate new data
			T* pNewData = XN_NEW_ARR(T, nReservedSize);
			XN_VALIDATE_ALLOC_PTR(pNewData);
			
			//Copy old data into new data
			for (XnUInt32 i = 0; i < m_nSize; i++)
			{
				pNewData[i] = m_pData[i];
			}

			//Delete old data
			XN_DELETE_ARR(m_pData);
			
			//Point to new data
			m_pData = pNewData;
			m_nAllocatedSize = nReservedSize;
		}
		return XN_STATUS_OK;
	}

	/** @returns TRUE if this array is empty, FALSE otherwise. **/
	XnBool IsEmpty() const