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

 //

 #ifndef __PARSER_H__

 #define __PARSER_H__

 /** 

 @file

 XML Framework CParser API header file.

 @publishedAll

 @released

 */

 #include <xml/contentprocessoruids.h> // needed for the typedef

 #include <xml/plugins/elementstack.h> // needed for the typedef

 class RFs;

 class RFile;

 namespace Xml

 {

 class MContentHandler;

 class RStringDictionaryCollection;

 class TParserImpl;

 class CMatchData;

 /** 

 If you need to parse xml this is the class you need to use.

 Default plain-text XML parser plug-in  supports following character set encodings: 

 ISO_8859_1

 US_ASCII

 UTF_8

 UTF_16

 UTF_16BE

 UTF_16LE

 @publishedAll

 @released

 */

 class CParser : public CBase

 	{

 public:

 	static IMPORT_C CParser* NewL(const TDesC8& aParserMimeType, MContentHandler& aCallback);

 	static IMPORT_C CParser* NewLC(const TDesC8& aParserMimeType, MContentHandler& aCallback);

 	static IMPORT_C CParser* NewL(const CMatchData& aCriteria, MContentHandler& aCallback);

 	static IMPORT_C CParser* NewLC(const CMatchData& aCriteria, MContentHandler& aCallback);

 	virtual ~CParser();

 	IMPORT_C void ParseBeginL();

 	IMPORT_C void ParseBeginL(const TDesC8& aDocumentMimeType);

 	IMPORT_C void ParseBeginL(const CMatchData& aCriteria);	

 	IMPORT_C void ParseL(const TDesC8& aFragment);

 	IMPORT_C void ParseEndL();

 	IMPORT_C void SetProcessorChainL(const RContentProcessorUids& aPlugins);

 	IMPORT_C TInt EnableFeature(TInt aParserFeature);

 	IMPORT_C TInt DisableFeature(TInt aParserFeature);

 	IMPORT_C TBool IsFeatureEnabled(TInt aParserFeature) const;

 	IMPORT_C void AddPreloadedDictionaryL(const TDesC8& aPublicId);

 	IMPORT_C RStringPool& StringPool();

 	IMPORT_C RStringDictionaryCollection& StringDictionaryCollection();

 private:

 	CParser();

 	void ConstructL(const TDesC8& aParserMimeType, MContentHandler& aCallback);

 	void ConstructL(const CMatchData& aMatchData, MContentHandler& aCallback);

 	TParserImpl* iImpl;

 	};

 IMPORT_C void ParseL(CParser& aParser, const TDesC8& aDocument);

 IMPORT_C void ParseL(CParser& aParser, RFs& aFs, const TDesC& aFilename);

 IMPORT_C void ParseL(CParser& aParser, RFile& aFile);

 }

 #endif //__PARSER_H__