--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/lowlevellibsandfws/genericusabilitylib/inc/emisc.h Tue Feb 02 02:01:42 2010 +0200
@@ -0,0 +1,59 @@
+// Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "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:
+//
+// Description:
+//
+
+#ifndef EMISC_H
+#define EMISC_H
+
+#include <e32base.h>
+
+/**
+ @file
+
+ Miscellaneous utilities that can help make code more readable.
+*/
+
+/**
+ A convenience postfix macro that is equivalent to wrapping the
+ preceding expression with User::LeaveIfError().
+
+ The code:
+ @code
+ fs.Connect() OR_LEAVE;
+ @endcode
+
+ is equivalent to:
+
+ @code
+ User::LeaveIfError(fs.Connect());
+ @endcode
+
+ The implementation happens to rely on overloading operator|| for
+ TLeave. However, this macro is not intended for use within general
+ expressions, just to guard individual calls to methods that may
+ return an error code.
+ */
+#define OR_LEAVE || ELeave
+
+/**
+ Enabling overload for OR_LEAVE. Should only be invoked via
+ OR_LEAVE, never directly.
+ */
+inline void operator||(TInt aStatus, TLeave /*aTag*/)
+ {
+ User::LeaveIfError(aStatus);
+ }
+
+#endif // !EMISC_H
+