1 parserfeature.h

     1 // Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).

     2 // All rights reserved.

     3 // This component and the accompanying materials are made available

     4 // 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

     5 // which accompanies this distribution, and is available

     6 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

     7 //

     8 // Initial Contributors:

     9 // Nokia Corporation - initial contribution.

    10 //

    11 // Contributors:

    12 //

    13 // Description:

    14 //

    15 

    16 #ifndef PARSERFEATURE_H

    17 #define PARSERFEATURE_H

    18 

    19 /** 

    20 @file

    21 @SYMPurpose Declares XML Framework parser features 

    22 @publishedAll

    23 @released

    24 */

    25 

    26 

    27 namespace Xml

    28 {

    29 

    30 /** Features defined for XML Framework parser plug-ins.

    31 

    32 Every parser has a set of optional features that it may implement. This

    33 enumeration is the set of all features known to the framework and its 

    34 plug-ins. Each feature is assigned a flag bit from the 32 possible.

    35 

    36 @see Xml::CParser::EnableFeature

    37 */

    38 enum TParserFeature 

    39 	{

    40 	/** Convert elements and attributes to lowercase. This can be used for 

    41 	case-insensitive HTML so that a tag can be matched to a static string in 

    42 	the string pool.

    43 	@see RStringPool */

    44 	EConvertTagsToLowerCase		= 0x0001,

    45 

    46 	/** Report an error when unrecognised tags are found. */

    47 	EErrorOnUnrecognisedTags	= 0x0002,

    48 

    49 	/** Reports unrecognised tags. */

    50 	EReportUnrecognisedTags		= 0x0004,

    51 

    52 	/** Report the namespace. */

    53 	EReportNamespaces			= 0x0008,

    54 

    55 	/** Report the namespace prefix. */

    56 	EReportNamespacePrefixes	= 0x0010,

    57 

    58 	/** Send all content data for an element in one chunk. */

    59 	ESendFullContentInOneChunk	= 0x0020,

    60 

    61 	/** Report namespace mappings via the OnStartPrefixMapping & 

    62 	OnEndPrefixMapping methods.

    63 	@see MContentHandler */

    64 	EReportNamespaceMapping		= 0x0040,

    65 

    66 	/** Describe the data in the specified encoding, otherwise use utf-8. */

    67 	ERawContent					= 0x0080,

    68 

    69 	/** When this feature is enabled the parser will allow (not generate an 

    70 	error) entities from external subsets to appear in element attribute 

    71 	values. When the replacement text of such entities are not known the

    72 	parser will	return the entity reference as it appears in the document 

    73 	e.g. "&ext_ref;" */

    74 	EReplaceIntEntityFromExtSubsetByRef = 0x0100,

    75 

    76 	/** When this feature is not supported the parser is an XML 1.0 parser.

    77 	When set parser can handle both XML 1.1 & 1.0 documents, otherwise just 

    78 	XML 1.0. Equivalent to the standard SAX2 feature "xml-1.1" */

    79 	EXmlVersion_1_1				= 0x0200,

    80 

    81 	/** Used to mark the highest flag in use.

    82 	Update to reflect any new enumerations added. */

    83 	ELastFeature               = EXmlVersion_1_1,

    84 	};

    85 

    86 }

    87 

    88 #endif // PARSERFEATURE_H