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-8D4AD37E-6B96-5B82-8313-F88D97531DEC" xml:lang="en"><title>Types

    13 of package</title><shortdesc>Describes the three types of package descriptors.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>Three types of package are available:</p>

    15 <ul>

    16 <li id="GUID-F6734EA9-F7C3-5BAD-8D3D-31E74459DE60"><p>a packaged modifiable

    17 buffer descriptor</p> </li>

    18 <li id="GUID-F445EFBB-BD50-5277-9C2B-89D1F23A3A8A"><p>a packaged non-modifiable

    19 pointer descriptor</p> </li>

    20 <li id="GUID-E9DA31C2-63B8-5A6F-B139-E165CE56F104"><p>a packaged modifiable

    21 pointer descriptor</p> </li>

    22 </ul>

    23 <section id="GUID-894BE487-84FA-4182-85F1-636A985819A9"><title>Packaged modifiable buffer descriptor</title> <p>This is an

    24 object of type <codeph>TPckgBuf</codeph> and is a modifiable buffer descriptor.

    25 The class is templated; the template parameter defines the type of object

    26 that this descriptor can contain.</p> <p>For example, a package descriptor

    27 of type <codeph>TPckgBuf&lt;TExample&gt;</codeph> is a modifiable buffer descriptor

    28 that only contains objects of type <codeph>TExample</codeph>.</p> <p>The package

    29 class also allows functions to be called on the contained class.</p> <fig id="GUID-7EE59907-F6E0-5200-A4BF-6AD5C9BE2D67">

    30 <image href="GUID-541C8505-335F-5C93-8C0E-96BCEE39D1E6_d0e232716_href.png" placement="inline"/>

    31 </fig> </section>

    32 <section id="GUID-C7714A6F-0E8D-43D4-B168-1EB333D8BCC7"><title>Packaged non-modifiable pointer descriptor</title> <p>This

    33 is an object of type <codeph>TPckgC</codeph> and is a non-modifiable pointer

    34 descriptor. The class is templated; the template parameter defines the type

    35 of object that this descriptor can represent.</p> <p>For example, a package

    36 descriptor of type <codeph>TPckgC&lt;TExample&gt;</codeph> is a non- modifiable

    37 pointer descriptor that only represents objects of type <codeph>TExample</codeph>.</p> <p>The

    38 package class also allows functions to be called on the contained class.</p> <fig id="GUID-31860379-F6A7-5D65-8160-EEDABBB73AD3">

    39 <image href="GUID-EA2AAE86-0BD3-52C9-BD13-75E9F04DE77F_d0e232744_href.png" placement="inline"/>

    40 </fig> </section>

    41 <section id="GUID-3AD2BB30-93E0-4E1F-B2BC-15693CE45A3E"><title>Packaged modifiable pointer descriptor</title> <p>This is

    42 an object of type <codeph>TPckg</codeph> and is a modifiable pointer descriptor.

    43 The class is templated; the template parameter defines the type of object

    44 that this descriptor can represent.</p> <p>For example, a package descriptor

    45 of type <codeph>TPckg&lt;TExample&gt;</codeph> is a modifiable pointer descriptor

    46 that only represents objects of type <codeph>TExample</codeph>.</p> <p>The

    47 package class also allows functions to be called on the contained class.</p> <fig id="GUID-5BB0AF3B-33FF-5374-A867-0BD49A15DC74">

    48 <image href="GUID-72B7B5CC-2E04-53CE-8414-C362DFD40D52_d0e232772_href.png" placement="inline"/>

    49 </fig> </section>

    50 <section id="GUID-2A10BADF-1BD3-4F78-B321-180132E8EA88"><title>See also</title> <p><xref href="GUID-0B9C8884-6BFF-35E2-AA6F-E4057B85AFCF.dita"><apiname>TBuf</apiname></xref> </p> <p><xref href="GUID-5CD07A27-E3ED-3273-A560-680501468C91.dita"><apiname>TPtrC</apiname></xref> </p> <p><xref href="GUID-EA7DEFA4-D4D9-3B2B-86A3-C3FB1A682E61.dita"><apiname>TPtr</apiname></xref> </p> </section>

    51 </conbody><related-links>

    52 <link>

    53 <desc><xref href="GUID-79BAF19D-F003-5468-9C01-6E918B06C36D.dita">Descriptor concepts</xref></desc>

    54 </link>

    55 </related-links></concept>