source: trunk/doc/src/platforms/symbian-exceptionsafety.qdoc@ 968

Last change on this file since 968 was 846, checked in by Dmitry A. Kuminov, 15 years ago

trunk: Merged in qt 4.7.2 sources from branches/vendor/nokia/qt.

  • Property svn:eol-style set to native
File size: 10.0 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation ([email protected])
6**
7** This file is part of the documentation of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:FDL$
10** Commercial Usage
11** Licensees holding valid Qt Commercial licenses may use this file in
12** accordance with the Qt Commercial License Agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in a
14** written agreement between you and Nokia.
15**
16** GNU Free Documentation License
17** Alternatively, this file may be used under the terms of the GNU Free
18** Documentation License version 1.3 as published by the Free Software
19** Foundation and appearing in the file included in the packaging of this
20** file.
21**
22** If you have questions regarding the use of this file, please contact
23** Nokia at [email protected].
24** $QT_END_LICENSE$
25**
26****************************************************************************/
27
28/*!
29 \page symbianexceptionsafety.html
30 \title Exception Safety with Symbian
31 \ingroup qtsymbian
32 \brief A guide to integrating exception safety in Qt with Symbian.
33
34 The following sections describe how Qt code can interoperate with Symbian's
35 exception safety system.
36
37 \tableofcontents
38
39 \section1 What the problem is
40
41 Qt and Symbian have different exception systems. Qt works with standard C++
42 exceptions, whereas Symbian has its TRAP/Leave/CleanupStack system. So, what would
43 happen if you mix the two systems? It could go wrong in a number of ways.
44
45 Clean-up ordering would be different between the two. When Symbian code
46 leaves, the clean-up stack is cleaned up before anything else happens. After
47 that, the objects on the call stack would be cleaned up as with a normal