epoc32/include/mw/attrlut.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:27:01 +0100
branchSymbian2
changeset 3 e1b950c65cb4
parent 2 epoc32/include/attrlut.h@2fe1408b6811
child 4 837f303aceeb
permissions -rw-r--r--
Attempt to represent the S^2->S^3 header reorganisation as a series of "hg rename" operations

// Copyright (c) 2000-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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
// which accompanies this distribution, and is available
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
// Attribute Look-Up-Table header
// The Attribute Lookup Table maintains a global set of unique IDs to be defined for document
// node attributes and language tags. It does this by generating a unique ID for any descriptor
// passed to it. This descriptor is in fact a pointer to a copy of the string. Once a string
// has been seen once, any further references to it will map back to the same ID (pointer)
// value.
// 
//

#if !defined(__CWAPENGINE_LUT_H__)
#define __CWAPENGINE_LUT_H__

#include <e32base.h>

class RTest;
class CAttributeLookupTableNode;

//##ModelId=3B666BC70189

class CAttributeLookupTable : public CBase
/** Provides an attribute lookup table, which maintains a global set of unique IDs to be defined 
	for document node attributes and language tags. 

	It does this by generating a unique (in the scope of the lookup table object) ID for any string 
	passed to it. Once a string has been seen once, any further references to it will map back to the 
	same ID value. 

	@publishedAll
	@released
*/
{
public:
	//##ModelId=3B666BC701E3
	IMPORT_C ~CAttributeLookupTable();
	//##ModelId=3B666BC701DC
	IMPORT_C static CAttributeLookupTable* CAttributeLookupTable::NewL();
	//##ModelId=3B666BC701DA
	IMPORT_C const HBufC* Des2IDL( const TDesC& ); // map descriptor to ID
	//##ModelId=3B666BC701D3
	IMPORT_C const HBufC* KeyExists( const TDesC& ); // check to see if the given descriptor already exists
	//##ModelId=3B666BC701D2
	IMPORT_C void Reset(); // clear the table

	// debug hook
	typedef enum{
		EPrint,
		EPrintWholeTable
	} TDebugSelectorType;
	//##ModelId=3B666BC701C6
	IMPORT_C void Debug( TDebugSelectorType aSelector, TAny* aParam1, TAny* aParam2 );

private:
	//##ModelId=3B666BC701C5
	CAttributeLookupTable();
	//##ModelId=3B666BC701BF
	void ConstructL();
	//##ModelId=3B666BC701BD
	CAttributeLookupTableNode* FindDes( const TDesC& );
	//##ModelId=3B666BC701BB
	TUint Hash( const TDesC& );
	//##ModelId=3B666BC701A9
	CArrayPtrFlat<CArrayPtrSeg<CAttributeLookupTableNode> >* iList;
};


#endif // __CWAPENGINE_LUT_H__