--- a/Symbian3/SDK/Source/GUID-DF1B3C55-2CFC-49C8-88A2-D10925ECAC3E.dita Wed Mar 31 11:11:55 2010 +0100
+++ b/Symbian3/SDK/Source/GUID-DF1B3C55-2CFC-49C8-88A2-D10925ECAC3E.dita Fri Jun 11 12:39:03 2010 +0100
@@ -1,143 +1,143 @@
-<?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-DF1B3C55-2CFC-49C8-88A2-D10925ECAC3E" xml:lang="en"><title>Known
-Issues</title><shortdesc/><prolog><metadata><keywords/></metadata></prolog><conbody>
-<section id="GUID-EB71EFD6-DBEC-4C0F-B9E5-3370204AE18A"><title>ARM RVCT compiler
-issues with STLport</title><p>Due to a defect in the ARM RVCT compiler versions
-2.2, 3.1 and 4.0, building STLport v4 or STLport-based applications, creates
-some invalid export entries in DEF files. To workaround this issue, perform
-the following steps:</p><ol>
-<li id="GUID-D5C91387-CF86-4D65-ACAF-05A5500DA090"><p>Use the GCCE compiler
-to generate the DEF file, if it is not available.</p></li>
-<li id="GUID-A0D36B39-ECEB-431A-80FD-6005542F4D7F"><p>Ignore the warnings
-generated by the ARM RVCT compiler.</p><note>When you ignore the warnings,
-do not freeze the invalid export entries in the DEF file using the ARM RVCT
-compiler.</note></li>
-</ol></section>
-<section id="GUID-DDE6596E-1A67-4219-8822-45A82C39DF0B-GENID-1-8-1-11-1-1-9-1-6-1-3-2"> <title>Use
-of Global Destructor</title> <p>Symbian does not invoke destructors
-of global objects upon program termination. For example, in the code below,
-the destructor <codeph>~foo()</codeph> is not called upon program termination.
-At the moment, it is advised not to perform any important operations using
-destructors.</p><codeblock xml:space="preserve">#include
-using namespace std;
-class foo
-{
-public:
-foo()
-{
-cout <<"Entering foo\n";
-}
-~foo()
-{
-cout <<"Leaving foo\n";
-}
-};
-foo foo_bar;
-int main(void)
-{
-return 0;
-}
-
-</codeblock> </section>
-<section id="GUID-DDE6596E-1A67-4219-8822-45A82C39DF0B-GENID-1-8-1-11-1-1-9-1-6-1-3-3"> <title>Issues
-with <codeph>new</codeph> operator</title> <p>Throwing <codeph>bad_alloc</codeph> or
-any object from new on ARMV5 platfrom crashes. RVCT reports an exception when <codeph>new</codeph> throws <codeph>bad_alloc</codeph>.
-The problem occurs even if the user throws any object from within an overloaded
-operator <codeph>new</codeph>. The following new signatures are affected:</p><codeblock xml:space="preserve">void *operator new(unsigned int aSize);
-void *operator new[](unsigned int aSize);
-</codeblock><p>The following code snippet is an example that depicts the problem:</p><codeblock xml:space="preserve">class Dummy
-{
-};
-void *operator new(unsigned int aSize)
-{
-void* __y = malloc(aSize);
-// try to simulate bad alloc
-if (__y == 0)
-{
-throw Dummy(); //this will result in a crash
-}
-return __y;
-}
-</codeblock><p>To implement user owned overloaded version of new, the user
-must implement them as class specific. The other way this could be achieved
-is by defining new similar to:</p><codeblock xml:space="preserve">void* operator new(size_t s,newarg) throw (std::bad_alloc)</codeblock><p>and
-invoking it as:</p><codeblock xml:space="preserve">Myclass* my = new(S60) Myclass()</codeblock>
- </section>
-<section id="GUID-DDE6596E-1A67-4219-8822-45A82C39DF0B-GENID-1-8-1-11-1-1-9-1-6-1-3-4"> <title>The <codeph>id</codeph> Member
-Issue</title> <p>The <codeph>id</codeph> member variable of facet classes
-cannot be accessed directly, it has to be accessed via the <codeph>GetFacetLocaleId()</codeph> interface.</p><p>Following
-code snippet is an example that illustrates how to <codeph>uselocale::id</codeph> while
-writing an application on top of the Standard Template Library (STL). Declare
-a static method <codeph>GetFacetLocaleId()</codeph> instead of the member
-variable id when, defining a class <codeph>base_facet</codeph> inherited from <codeph>locale::facet</codeph> in
-a header file.</p><codeblock xml:space="preserve">//b_facet.h
-class base_facet : public locale::facet
-{
-public:
-static locale::id;
-GetFacetLocaleId(); // in place of static locale::id
-id;
-};
-</codeblock><p>In the source file define the method <codeph>GetFacetLocaleId()</codeph>. </p><codeblock xml:space="preserve">//b_facet.cpp
-locale::id base_facet_id;
-locale::id& base_facet::GetFacetLocaleId()
-{
-return base_facet_id;
-}
-</codeblock> </section>
-<section id="GUID-0EBB7F0F-2C2D-4707-BD53-96DC40443CAF"><title>Interleaving
-Symbian and Standard C++ Code</title><p>The user must exercise caution while
-using <codeph>try</codeph> or <codeph>catch</codeph>, and <codeph>trap</codeph> while
-interleaving Symbian C++ and Standard C++ code. Adapter code is required to
-handover or suppress exception coming from the Standard C++ to Symbian C++
-code.</p><p>Following code snippet illustrates how to use the adaptor code.
-Adaptor code can be a part of DLLA. </p><p><b>DLL A - Symbian C++ code</b></p><codeblock xml:space="preserve">void CDoIt::Doit()
-{
- class foo *p = new __foo__();
- p->bar();
- delete p;
-};
-</codeblock><p><b>DLLB - Standard C++ code</b></p><codeblock xml:space="preserve">class foo {
-public:
- foo(); //constructor
- bar(); // throw exception
-};
-</codeblock><p><b>DLLC - Adaptor code</b></p><codeblock xml:space="preserve">class __foo__ {
- foo *p;
-public:
- __foo__();
- bar();
-};
-
-void __foo__::__foo__()
-{
- int err = 0;
- try {
- p = new foo();
- } catch {
- err = some error
- }
- User::LeaveIfError(err);
-};
-void __foo__::bar()
-{
- int err = 0;
- try {
- p->bar();
- } catch {
- err = some error
- }
- User::LeaveIfError(err);
-};
-</codeblock></section>
+<?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-DF1B3C55-2CFC-49C8-88A2-D10925ECAC3E" xml:lang="en"><title>Known
+Issues</title><shortdesc/><prolog><metadata><keywords/></metadata></prolog><conbody>
+<section id="GUID-EB71EFD6-DBEC-4C0F-B9E5-3370204AE18A"><title>ARM RVCT compiler
+issues with STLport</title><p>Due to a defect in the ARM RVCT compiler versions
+2.2, 3.1 and 4.0, building STLport v4 or STLport-based applications, creates
+some invalid export entries in DEF files. To workaround this issue, perform
+the following steps:</p><ol>
+<li id="GUID-D5C91387-CF86-4D65-ACAF-05A5500DA090"><p>Use the GCCE compiler
+to generate the DEF file, if it is not available.</p></li>
+<li id="GUID-A0D36B39-ECEB-431A-80FD-6005542F4D7F"><p>Ignore the warnings
+generated by the ARM RVCT compiler.</p><note>When you ignore the warnings,
+do not freeze the invalid export entries in the DEF file using the ARM RVCT
+compiler.</note></li>
+</ol></section>
+<section id="GUID-DDE6596E-1A67-4219-8822-45A82C39DF0B-GENID-1-10-1-11-1-1-9-1-6-1-3-2"> <title>Use
+of Global Destructor</title> <p>Symbian does not invoke destructors
+of global objects upon program termination. For example, in the code below,
+the destructor <codeph>~foo()</codeph> is not called upon program termination.
+At the moment, it is advised not to perform any important operations using
+destructors.</p><codeblock xml:space="preserve">#include
+using namespace std;
+class foo
+{
+public:
+foo()
+{
+cout <<"Entering foo\n";
+}
+~foo()
+{
+cout <<"Leaving foo\n";
+}
+};
+foo foo_bar;
+int main(void)
+{
+return 0;
+}
+
+</codeblock> </section>
+<section id="GUID-DDE6596E-1A67-4219-8822-45A82C39DF0B-GENID-1-10-1-11-1-1-9-1-6-1-3-3"> <title>Issues
+with <codeph>new</codeph> operator</title> <p>Throwing <codeph>bad_alloc</codeph> or
+any object from new on ARMV5 platfrom crashes. RVCT reports an exception when <codeph>new</codeph> throws <codeph>bad_alloc</codeph>.
+The problem occurs even if the user throws any object from within an overloaded
+operator <codeph>new</codeph>. The following new signatures are affected:</p><codeblock xml:space="preserve">void *operator new(unsigned int aSize);
+void *operator new[](unsigned int aSize);
+</codeblock><p>The following code snippet is an example that depicts the problem:</p><codeblock xml:space="preserve">class Dummy
+{
+};
+void *operator new(unsigned int aSize)
+{
+void* __y = malloc(aSize);
+// try to simulate bad alloc
+if (__y == 0)
+{
+throw Dummy(); //this will result in a crash
+}
+return __y;
+}
+</codeblock><p>To implement user owned overloaded version of new, the user
+must implement them as class specific. The other way this could be achieved
+is by defining new similar to:</p><codeblock xml:space="preserve">void* operator new(size_t s,newarg) throw (std::bad_alloc)</codeblock><p>and
+invoking it as:</p><codeblock xml:space="preserve">Myclass* my = new(S60) Myclass()</codeblock>
+ </section>
+<section id="GUID-DDE6596E-1A67-4219-8822-45A82C39DF0B-GENID-1-10-1-11-1-1-9-1-6-1-3-4"> <title>The <codeph>id</codeph> Member
+Issue</title> <p>The <codeph>id</codeph> member variable of facet classes
+cannot be accessed directly, it has to be accessed via the <codeph>GetFacetLocaleId()</codeph> interface.</p><p>Following
+code snippet is an example that illustrates how to <codeph>uselocale::id</codeph> while
+writing an application on top of the Standard Template Library (STL). Declare
+a static method <codeph>GetFacetLocaleId()</codeph> instead of the member
+variable id when, defining a class <codeph>base_facet</codeph> inherited from <codeph>locale::facet</codeph> in
+a header file.</p><codeblock xml:space="preserve">//b_facet.h
+class base_facet : public locale::facet
+{
+public:
+static locale::id;
+GetFacetLocaleId(); // in place of static locale::id
+id;
+};
+</codeblock><p>In the source file define the method <codeph>GetFacetLocaleId()</codeph>. </p><codeblock xml:space="preserve">//b_facet.cpp
+locale::id base_facet_id;
+locale::id& base_facet::GetFacetLocaleId()
+{
+return base_facet_id;
+}
+</codeblock> </section>
+<section id="GUID-0EBB7F0F-2C2D-4707-BD53-96DC40443CAF"><title>Interleaving
+Symbian and Standard C++ Code</title><p>The user must exercise caution while
+using <codeph>try</codeph> or <codeph>catch</codeph>, and <codeph>trap</codeph> while
+interleaving Symbian C++ and Standard C++ code. Adapter code is required to
+handover or suppress exception coming from the Standard C++ to Symbian C++
+code.</p><p>Following code snippet illustrates how to use the adaptor code.
+Adaptor code can be a part of DLLA. </p><p><b>DLL A - Symbian C++ code</b></p><codeblock xml:space="preserve">void CDoIt::Doit()
+{
+ class foo *p = new __foo__();
+ p->bar();
+ delete p;
+};
+</codeblock><p><b>DLLB - Standard C++ code</b></p><codeblock xml:space="preserve">class foo {
+public:
+ foo(); //constructor
+ bar(); // throw exception
+};
+</codeblock><p><b>DLLC - Adaptor code</b></p><codeblock xml:space="preserve">class __foo__ {
+ foo *p;
+public:
+ __foo__();
+ bar();
+};
+
+void __foo__::__foo__()
+{
+ int err = 0;
+ try {
+ p = new foo();
+ } catch {
+ err = some error
+ }
+ User::LeaveIfError(err);
+};
+void __foo__::bar()
+{
+ int err = 0;
+ try {
+ p->bar();
+ } catch {
+ err = some error
+ }
+ User::LeaveIfError(err);
+};
+</codeblock></section>
</conbody></concept>
\ No newline at end of file