/*
* 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 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:
*
* Description: 
* Contains miscellaneous utility functions that can be used by any code in security component
*
*/


/**
 @file
 @publishedPartner
 @released
*/

#ifndef __MISCUTIL_H__
#define __MISCUTIL_H__

#include <e32base.h>
#include <f32file.h>

/**
 * This namespace contains common miscellaneous utilitarian functionality meant from use in security code
 */

namespace MiscUtil
	{
	/*
	 * Recursively deletes all folders in the path (as long as they are empty)
	 *
	 * @param aFs		Connected  filesystem session
	 * @param aPath		Fully qualified path to start the recursive delete
	 */
	IMPORT_C void DeletePathIfEmpty(RFs& aFs, const TDesC& aPath);
	/*
	 * Function used to extract lines of text from a buffer. Note that this only works for non-unicode text. It skips
	 * over blank lines and the characters '\n' or '\r' are treated as end-of-line markers.
	 *
	 * @param aBuffer		Input buffer
	 * @param aPos		Starting index into aBuffer (should be within the bounds of zero and length of buffer). 
	 *				It is updated after processing and should be passed in unchanged to correctly identify next line
	 * @param aLine		Set to point to the start of the line identified
	 * @return			ETrue if a line was successfully extracted from the buffer, EFalse if end of buffer reached
	 */
	IMPORT_C TBool ReadNonEmptyLineL(const TDesC8& aBuffer, TInt& aPos, TPtrC8& aLine);
	}

#endif // __MISCUTIL_H__