Symbian3/PDK/Source/GUID-2C7AF56F-F741-5C9B-83B9-46C175330ED1.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Tue, 30 Mar 2010 11:56:28 +0100
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 14 578be2adaf3e
permissions -rw-r--r--
Week 12 contribution of PDK documentation_content. See release notes for details. Fixes Bug 2054, Bug 1583, Bug 381, Bug 390, Bug 463, Bug 1897, Bug 344, Bug 1319, Bug 394, Bug 1520, Bug 1522, Bug 1892"

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-2C7AF56F-F741-5C9B-83B9-46C175330ED1" xml:lang="en"><title>Safe
data access</title><shortdesc>Describes how the parameters that are passed to the descriptors
are checked to ensure the they are not accessing illegal data.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>The parameters that are passed to descriptor functions which access or
operate on data, are checked to ensure that those operations are correctly
specified and that no data outside the data area represented by the descriptor
is accessed or changed.</p>
<p>It is the programmer’s responsibility to ensure that all accesses to descriptor
data are within bounds and that descriptors are sufficiently large to contain
their data, either by making the original allocation large enough at program
compile time or by dynamically allocating the descriptor at run-time.</p>
<p>An illegal data access raises an exception, known as a panic, causing immediate
program termination. In this event, it can be assumed that no illegal access
of memory has taken place and that no data has been moved or damaged.</p>
<p>The Format() function which operates on descriptor data is the only case
where a program is offered the opportunity to handle a potential exception.</p>
<section id="GUID-6C0DFCF4-2742-4F07-A161-A1A23879F99F"><title>See also</title> <p><xref href="GUID-445B19E5-E2EE-32E2-8D6C-C7D6A9B3C507.dita#GUID-445B19E5-E2EE-32E2-8D6C-C7D6A9B3C507/GUID-EE7DBF18-A16C-3983-924F-20C1907E7AAA"><apiname>TDes8::Format()</apiname></xref> </p> <p><xref href="GUID-C04A9A0C-DBA7-37DA-B744-54FBF3D544CD.dita#GUID-C04A9A0C-DBA7-37DA-B744-54FBF3D544CD/GUID-F3ED8A38-74C5-3C4D-AEAF-B405A0C5807D"><apiname>TDes16::Format()</apiname></xref> </p> </section>
</conbody></concept>