|
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-978DFDB1-4B20-5302-A9E4-9C7404A7CB16" xml:lang="en"><title>The range |
|
13 checking wrapper for fixed length C++ arrays</title><shortdesc>C++ arrays do not provide range checking so Symbian platform offers |
|
14 a thin wrapper to add this functionality to arrays.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <p>The C++ language provides <i>fixed length</i> arrays.</p> |
|
16 <p>It is often convenient to use these arrays in applications whenever the |
|
17 number of elements is fixed and known at compile time.</p> |
|
18 <p>The main disadvantage of using C++ arrays is that there is no automatic |
|
19 checking of index value. This means that it is possible to write over data |
|
20 that lies beyond the end of the allocated array size, and to read invalid |
|
21 data from beyond the end of the array.</p> |
|
22 <p>The templated class <codeph>TFixedArray<class T,TInt S></codeph>, is |
|
23 a thin wrapper for C++ arrays. The major benefits of using this class over |
|
24 a basic C++ array are the provision of range-checked indexing and support |
|
25 for object deletion. There is no runtime penalty for using this class if debug-only |
|
26 range-checking is used.</p> |
|
27 <p>The class can be embedded as a data member of <codeph>CBase</codeph>-derived |
|
28 objects. The class can also be used on the program stack.</p> |
|
29 </conbody></concept> |