diff -r 000000000000 -r bde4ae8d615e os/ossrv/lowlevellibsandfws/genericusabilitylib/inc/emisc.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/os/ossrv/lowlevellibsandfws/genericusabilitylib/inc/emisc.h Fri Jun 15 03:10:57 2012 +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 + +/** + @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 +