Symbian3/PDK/Source/GUID-FC24C65C-0DCB-5E07-9A68-9001D34664DD.dita
changeset 5 f345bda72bc4
parent 3 46218c8b8afa
child 14 578be2adaf3e
--- a/Symbian3/PDK/Source/GUID-FC24C65C-0DCB-5E07-9A68-9001D34664DD.dita	Tue Mar 30 11:42:04 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-FC24C65C-0DCB-5E07-9A68-9001D34664DD.dita	Tue Mar 30 11:56:28 2010 +0100
@@ -1,18 +1,18 @@
-<?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 xml:lang="en" id="GUID-FC24C65C-0DCB-5E07-9A68-9001D34664DD"><title>OR_LEAVE MACRO</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>The <xref href="GUID-7EB97E3A-90F5-3536-B7AC-F6F55023E2F3.dita"><apiname>OR_LEAVE</apiname></xref> macro is a convenient macro that allows the application developer to de-emphasize auxiliary error checking code in most cases. It is a postfix macro which implements <xref href="GUID-C197C9A7-EA05-3F24-9854-542E984C612D.dita#GUID-C197C9A7-EA05-3F24-9854-542E984C612D/GUID-80E99D34-F4A1-36EA-AD64-E14ACAEC99B0"><apiname>User::LeaveIfError</apiname></xref> on an integer return type. This means that there is less focus on the error handling code and makes the code easier to read. </p> <section><title>Need for OR_Leave Macro</title> <p>Motive behind using a <xref href="GUID-7EB97E3A-90F5-3536-B7AC-F6F55023E2F3.dita"><apiname>OR_LEAVE</apiname></xref> macro is that it should not return an integer value. It is intended for use as a postfix macro at the end of a statement. If OR_LEAVE was to return an integer value, it would encourage its use in the middle of expressions negating its intended purpose which is to reduce the focus on error checking code. </p> </section> <example><title>Defining OR_Leave Macro</title> <p>The OR_LEAVE macro is defined as a postfix operator as shown below: </p> <codeblock id="GUID-DDB19E73-7D96-5D06-8EF9-AEC1248E8644" xml:space="preserve">
-        #define OR_LEAVE || ELeave
-        inline void operator||(TInt aStatus, TLeave /*aTag*/)
-            {
-            User::LeaveIfError(aStatus);
-            }
+<?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 xml:lang="en" id="GUID-FC24C65C-0DCB-5E07-9A68-9001D34664DD"><title>OR_LEAVE MACRO</title><prolog><metadata><keywords/></metadata></prolog><conbody><p>The <xref href="GUID-7EB97E3A-90F5-3536-B7AC-F6F55023E2F3.dita"><apiname>OR_LEAVE</apiname></xref> macro is a convenient macro that allows the application developer to de-emphasize auxiliary error checking code in most cases. It is a postfix macro which implements <xref href="GUID-C197C9A7-EA05-3F24-9854-542E984C612D.dita#GUID-C197C9A7-EA05-3F24-9854-542E984C612D/GUID-80E99D34-F4A1-36EA-AD64-E14ACAEC99B0"><apiname>User::LeaveIfError</apiname></xref> on an integer return type. This means that there is less focus on the error handling code and makes the code easier to read. </p> <section><title>Need for OR_Leave Macro</title> <p>Motive behind using a <xref href="GUID-7EB97E3A-90F5-3536-B7AC-F6F55023E2F3.dita"><apiname>OR_LEAVE</apiname></xref> macro is that it should not return an integer value. It is intended for use as a postfix macro at the end of a statement. If OR_LEAVE was to return an integer value, it would encourage its use in the middle of expressions negating its intended purpose which is to reduce the focus on error checking code. </p> </section> <example><title>Defining OR_Leave Macro</title> <p>The OR_LEAVE macro is defined as a postfix operator as shown below: </p> <codeblock id="GUID-DDB19E73-7D96-5D06-8EF9-AEC1248E8644" xml:space="preserve">
+        #define OR_LEAVE || ELeave
+        inline void operator||(TInt aStatus, TLeave /*aTag*/)
+            {
+            User::LeaveIfError(aStatus);
+            }
 </codeblock> </example> <section><title>See Also</title> <p><xref href="GUID-B007634D-4D55-528A-8B85-6120C633AC8B.dita">EUser High Level Library Overview</xref>  </p> <p><xref href="GUID-D33EB877-CCCB-527B-8AFC-4A8385C55E78.dita">EUser High Level Library Tutorials</xref>  </p> </section> </conbody></concept>
\ No newline at end of file