// Copyright (c) 2004-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:

//

/**

 @file

 @internalTechnology

*/

#ifndef __CFEXTRAS_H__

#define __CFEXTRAS_H__

#include <e32base.h>

#include <f32file.h>

#include "elements/cftransportmacro.h"

// This namespace is split between this file and cfutil.h. You can include this file to use COwnEntryList

// etc without having to include the other - including cfutil.h requires that you link against commsfw and

// so requires any component using anything that includes cfutil.h to link against commsfw (nasty).

namespace CommsFW

//CommsFW namespace doxygen is supplied in cfmsgs.h. The namespace is publishedPartner, released

//The items in this header are all internal technology.

{

#ifdef SYMBIAN_TRACE_ENABLE	

	const TInt KMaxLogTextLength = 250;

	const TInt KPrimaryFilter = 194;

#endif

enum { KMaxIniDataSectionNameLength = 32 };

IMPORT_C TBool GetVarFromIniData(const TDesC8& aIniData, const TDesC8& aSection, const TDesC8& aVarName, TPtrC8& aResult);

IMPORT_C TBool GetVarFromIniData(const TDesC8& aIniData, const TDesC8 &aSection, const TDesC8 &aVarName, TInt &aResult);

class COwnEntryList : public CBase

	{

public:

	class TOwnEntry : public TEntry

		{

	public:

		IMPORT_C TOwnEntry(const TParse& aPath, const TEntry& aEntry);

		};

	IMPORT_C explicit COwnEntryList(TInt aGranularity);

	IMPORT_C ~COwnEntryList();

	IMPORT_C void WildScanAcrossDrivesL(const TDesC& aDir, const TDesC& aFileMask);

	IMPORT_C void UniqueWildScanAcrossDrivesL(const TDesC& aDir, const TDesC& aFileMask);

	IMPORT_C void AddL(const COwnEntryList& aDir);

	IMPORT_C void AddL(const TOwnEntry& aEntry);

	IMPORT_C TInt Count() const;

	IMPORT_C const TOwnEntry& operator[](TInt anIndex) const;

protected:

private:

	RArray<TOwnEntry> iArray;

	};

// Small extension of platform RHeap, exposing the access count and a means

// of logging all remaining allocated cells

class RCFSharedHeap : public RHeap

	{

public:

	IMPORT_C TInt AccessCount() const;

	IMPORT_C void LogAllocatedCells(const TDesC8& aSubSystem, const TDesC8& aComponent);

private:

#if defined(__FLOG_ACTIVE) || defined(SYMBIAN_TRACE_ENABLE)

#ifdef SYMBIAN_TRACE_ENABLE	

	class TLogTextBuf : public TBuf8<KMaxLogTextLength>

	    {

	public:

	    class TLogIgnoreOverflow8 : public TDes8Overflow

	        {

	        public:

	            void Overflow(TDes8& /*aDes*/) { }

	        };

	    void AppendFormatIgnoreOverflow(TRefByValue<const TDesC8> aFmt, ...)

	        {

	    	TLogIgnoreOverflow8 overflowHandler;

	    	VA_LIST list;

	    	VA_START(list, aFmt);

	    	AppendFormatList(aFmt, list, &overflowHandler);

	    	VA_END(list);

	        }	    

	    };

#endif	   

	class TLogInfo

		{

	public:

		TLogInfo(const TDesC8& aSubSystem, const TDesC8& aComponent)

		: iSubSystem(aSubSystem), iComponent(aComponent)

			{ }

	public:

		const TDesC8& iSubSystem;

		const TDesC8& iComponent;

		};

	static void WalkFunc(TAny* aContext, TCellType aType, TAny* aCell, TInt aSize);

#endif

	};

} // CommsFW

#endif