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

// Processing instruction node functions

//

/**

 @file

 @publishedAll

 @released

*/

#ifndef XMLENGPROCESSINGINSTRUCTION_H

#define XMLENGPROCESSINGINSTRUCTION_H

#include <xml/dom/xmlengnode.h>

/**

This class represents an XML processing instruction in the DOM tree.  This class

is usually instantiated through RXmlEngDocument::CreateProcessingInstruction().

*/

class TXmlEngProcessingInstruction : public TXmlEngNode

{

  public:

    /** Default constructor */

	inline TXmlEngProcessingInstruction();

    /**

	Gets a reference to the the target part of the processing instruction.

    @code

        <?target data?>

    @endcode

    @see http://www.w3.org/TR/2004/REC-xml-20040204/#sec-pi

    @return A reference to the target part

    */

    IMPORT_C TPtrC8 Target() const;

    /**

    Gets a reference to the data part of the processing instruction.

    @code

        <?target data?>

    @endcode

    @see http://www.w3.org/TR/2004/REC-xml-20040204/#sec-pi

    @return A reference to the data part

    */

    IMPORT_C TPtrC8 Data() const;

    /**

	Copies the parameter and sets the data part of the processing instruction.

	Note: The processing instruction contents should not contain the "?>"

	sequence

    @param aData The data part to set

	@leave - One of the system-wide error codes

    */

    IMPORT_C void SetDataL(const TDesC8& aData);

protected:

    /**

    Constructor

    @param aInternal Processing instruction pointer

    */

	inline TXmlEngProcessingInstruction(void* aInternal);

};

#include <xml/dom/xmlengprocessinginstruction.inl>

#endif /* XMLENGPROCESSINGINSTRUCTION_H */