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

 // All text nodes functions

 //

 /**

  @file

  @publishedAll

  @released

 */

 #ifndef XMLENGCHARACTERDATA_H

 #define XMLENGCHARACTERDATA_H

 #include <xml/dom/xmlengnode.h>

 /**

 This class represents XML text nodes in the DOM tree.  Inherited classes

 further specialize (e.g. TXmlEngTextNode, TXmlEngComment).

 The CharacterData Interface is described by the DOM Spec here:

 http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407/core.html#ID-FF21A306

 */

 class TXmlEngCharacterData : public TXmlEngNode

 {

 public:

     /** Get contents of the node.

     @return The content of the node

     */

     IMPORT_C TPtrC8 Contents() const;

     /**

     Sets contents of the node.

     The input is taken as non-escaped: for example, 

     aNewContents = "123 > 34 && P" will be serialized as "123 > 34 && P"

     @param aNewContents  The actual value to store

 	@leave - One of the system-wide error codes

     */

     IMPORT_C void SetContentsL(const TDesC8& aNewContents);

     /** Append to the contents of the node

     @param aString Content to be appended

 	@leave KXmlEngErrNullNode Node is NULL

 	@leave - One of the system-wide error codes

     */

     IMPORT_C void AppendContentsL(const TDesC8& aString);

     /** Get length of the content.

     @return Number of characters in the contents

     */

     IMPORT_C TUint Length() const;

 protected:

     /** Default constructor */

 	inline TXmlEngCharacterData(); 

     /**

     Constructor

     @param aInternal node pointer

     */

 	inline TXmlEngCharacterData(void* aInternal);

 };

 #include <xml/dom/xmlengcharacterdata.inl>

 #endif /* XMLENGCHARACTERDATA_H */