epoc32/include/xml/parserfeature.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
parent 2 2fe1408b6811
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h)
This is the epoc32/include tree with the "platform" subtrees removed, and
all but a selected few mbg and rsg files removed.
williamr@2
     1
// Copyright (c) 2003-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2
     2
// All rights reserved.
williamr@2
     3
// This component and the accompanying materials are made available
williamr@4
     4
// under the terms of "Eclipse Public License v1.0"
williamr@2
     5
// which accompanies this distribution, and is available
williamr@4
     6
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@2
     7
//
williamr@2
     8
// Initial Contributors:
williamr@2
     9
// Nokia Corporation - initial contribution.
williamr@2
    10
//
williamr@2
    11
// Contributors:
williamr@2
    12
//
williamr@2
    13
// Description:
williamr@2
    14
//
williamr@2
    15
williamr@2
    16
#ifndef PARSERFEATURE_H
williamr@2
    17
#define PARSERFEATURE_H
williamr@2
    18
williamr@2
    19
/** 
williamr@2
    20
@file
williamr@2
    21
@SYMPurpose Declares XML Framework parser features 
williamr@2
    22
@publishedAll
williamr@2
    23
@released
williamr@2
    24
*/
williamr@2
    25
williamr@2
    26
williamr@2
    27
namespace Xml
williamr@2
    28
{
williamr@2
    29
williamr@2
    30
/** Features defined for XML Framework parser plug-ins.
williamr@2
    31
williamr@2
    32
Every parser has a set of optional features that it may implement. This
williamr@2
    33
enumeration is the set of all features known to the framework and its 
williamr@2
    34
plug-ins. Each feature is assigned a flag bit from the 32 possible.
williamr@2
    35
williamr@2
    36
@see Xml::CParser::EnableFeature
williamr@2
    37
*/
williamr@2
    38
enum TParserFeature 
williamr@2
    39
	{
williamr@2
    40
	/** Convert elements and attributes to lowercase. This can be used for 
williamr@2
    41
	case-insensitive HTML so that a tag can be matched to a static string in 
williamr@2
    42
	the string pool.
williamr@2
    43
	@see RStringPool */
williamr@2
    44
	EConvertTagsToLowerCase		= 0x0001,
williamr@2
    45
williamr@2
    46
	/** Report an error when unrecognised tags are found. */
williamr@2
    47
	EErrorOnUnrecognisedTags	= 0x0002,
williamr@2
    48
williamr@2
    49
	/** Reports unrecognised tags. */
williamr@2
    50
	EReportUnrecognisedTags		= 0x0004,
williamr@2
    51
williamr@2
    52
	/** Report the namespace. */
williamr@2
    53
	EReportNamespaces			= 0x0008,
williamr@2
    54
williamr@2
    55
	/** Report the namespace prefix. */
williamr@2
    56
	EReportNamespacePrefixes	= 0x0010,
williamr@2
    57
williamr@2
    58
	/** Send all content data for an element in one chunk. */
williamr@2
    59
	ESendFullContentInOneChunk	= 0x0020,
williamr@2
    60
williamr@2
    61
	/** Report namespace mappings via the OnStartPrefixMapping & 
williamr@2
    62
	OnEndPrefixMapping methods.
williamr@2
    63
	@see MContentHandler */
williamr@2
    64
	EReportNamespaceMapping		= 0x0040,
williamr@2
    65
williamr@2
    66
	/** Describe the data in the specified encoding, otherwise use utf-8. */
williamr@2
    67
	ERawContent					= 0x0080,
williamr@2
    68
williamr@2
    69
	/** When this feature is enabled the parser will allow (not generate an 
williamr@2
    70
	error) entities from external subsets to appear in element attribute 
williamr@2
    71
	values. When the replacement text of such entities are not known the
williamr@2
    72
	parser will	return the entity reference as it appears in the document 
williamr@2
    73
	e.g. "&ext_ref;" */
williamr@2
    74
	EReplaceIntEntityFromExtSubsetByRef = 0x0100,
williamr@2
    75
williamr@2
    76
	/** When this feature is not supported the parser is an XML 1.0 parser.
williamr@2
    77
	When set parser can handle both XML 1.1 & 1.0 documents, otherwise just 
williamr@2
    78
	XML 1.0. Equivalent to the standard SAX2 feature "xml-1.1" */
williamr@2
    79
	EXmlVersion_1_1				= 0x0200,
williamr@2
    80
williamr@2
    81
	/** Used to mark the highest flag in use.
williamr@2
    82
	Update to reflect any new enumerations added. */
williamr@2
    83
	ELastFeature               = EXmlVersion_1_1,
williamr@2
    84
	};
williamr@2
    85
williamr@2
    86
}
williamr@2
    87
williamr@2
    88
#endif // PARSERFEATURE_H