lowlevellibsandfws/genericusabilitylib/inc/emisc.h
changeset 0 e4d67989cc36
--- /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
+