1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-FF0330E8-81CA-52F3-AD60-89360B74B25D" xml:lang="en"><title>Using

    13 CArrayVar&lt;TAny&gt;</title><shortdesc>The <codeph>CArrayVar&lt;TAny&gt;</codeph> class is useful for constructing

    14 an array of variable length buffers, where the length is decided at run time.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <section id="GUID-763A4737-913B-417F-A9A6-CB1844EC64F6"><title>Arrays whose type is not known until class instantiation</title> <p>The <codeph>CArrayVar&lt;TAny&gt;</codeph> class

    16 is useful for constructing an array of variable length buffers, where the

    17 length is decided at run time. It is also useful as a data member of a base

    18 class in a thin template class/base class pair,where the type of the array

    19 element is not known until the owning thin template class is instantiated.</p> <p>For

    20 example, to implement a stack of variable length objects of type <codeph>T</codeph>.</p> <codeblock id="GUID-4478A571-F004-5015-9D35-DBEABFDBCFF1" xml:space="preserve">class CExampleBase : public CBase

    21  {

    22 public :

    23  ...

    24 protected :

    25  ...

    26  void  PushL(const TAny* aPtr);

    27  TAny* Pop();

    28 private :

    29  CArrayVar<TAny> iArray;

    30  }</codeblock> <codeblock id="GUID-3EEED66E-A71A-597D-82B5-E2EAD5AC93CC" xml:space="preserve">template &lt;class T&gt;

    31 class CExample : public CExampleBase

    32  {

    33 public :

    34  ...

    35  inline void PushL(const T* aPtr);

    36  inline T*   Pop();

    37  }</codeblock> </section>

    38 </conbody></concept>