Xalan-C++ API Documentation

The Xalan C++ XSLT Processor Version 1.10

             

---

ElemForEach.hpp

Go to the documentation of this file.

/*
 * Copyright 1999-2004 The Apache Software Foundation.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
#if !defined(XALAN_ELEMFOREACH_HEADER_GUARD)
#define XALAN_ELEMFOREACH_HEADER_GUARD 



// Base include file.  Must be first.
#include "XSLTDefinitions.hpp"



#include <xalanc/Include/XalanVector.hpp>



// Base class header file.
#include "ElemTemplateElement.hpp"



#include <xalanc/XPath/NodeRefListBase.hpp>
#include <xalanc/XPath/MutableNodeRefList.hpp>
#include <xalanc/XPath/XObject.hpp>



#include "Constants.hpp"



XALAN_CPP_NAMESPACE_BEGIN



class ElemSort;
class ElemTemplate;
class NodeSorter;
class XPath;



class ElemForEach: public ElemTemplateElement
{
public:

    ElemForEach(
            StylesheetConstructionContext&  constructionContext,
            Stylesheet&                     stylesheetTree,
            const AttributeListType&        atts,
            int                             lineNumber,
            int                             columnNumber);

    virtual
    ~ElemForEach();

    typedef XalanVector<ElemSort*>      SortElemsVectorType;

    // These methods are inherited from ElemTemplateElement ...

    virtual const XalanDOMString&
    getElementName() const;

    virtual void
    processSortElement(
            StylesheetConstructionContext&  constructionContext,
            Stylesheet&                     theStylesheet,
            const AttributeListType&        atts,
            const LocatorType*              locator = 0);

    virtual void
    postConstruction(
            StylesheetConstructionContext&  constructionContext,
            const NamespacesHandler&        theParentHandler);

#if !defined(XALAN_RECURSIVE_STYLESHEET_EXECUTION)
    virtual const ElemTemplateElement*
    startElement(StylesheetExecutionContext&    executionContext) const;
    
    virtual void
    endElement(StylesheetExecutionContext&      executionContext) const;

    virtual const ElemTemplateElement*
    getNextChildElemToExecute(
               StylesheetExecutionContext&  executionContext,
               const ElemTemplateElement*   currentElem) const;
#else
    virtual void
    execute(StylesheetExecutionContext&     executionContext) const;
#endif
    
    virtual const XPath*
    getXPath(unsigned int   index = 0) const;

protected:

    ElemForEach(
            StylesheetConstructionContext&  constructionContext,
            Stylesheet&                     stylesheetTree,
            int                             lineNumber,
            int                             columnNumber,
            int                             xslToken);

#if !defined(XALAN_RECURSIVE_STYLESHEET_EXECUTION)

    /*
     * Returns a pointer to a list of the selected nodes.  The
     * nodes are sorted if required. 
     * 
     * @param executionContext  context for executing this element
     * @return pointer to the list of selected (and sorted) nodes
     */
    virtual const NodeRefListBase*
    createSelectedAndSortedNodeList(
            StylesheetExecutionContext&     executionContext) const;
    
    /*
     * Release any objects used to maintain the last selected 
     * (and sorted) node list to be created
     * 
     * @param executionContext  context for executing this element
     */
    virtual void
    releaseSelectedAndSortedNodeList(
            StylesheetExecutionContext&     executionContext) const;

    /*
     * Sorts a list of nodes 
     *
     * @param executionContext  context for executing this element
     * @param selectedNodeList  list of nodes to be sorted
     * @param sortedNodeList    list for sorted nodes
     *
     * @returns pointer to list of sorted nodes
     */
    virtual const NodeRefListBase*
    sortChildren(   
            StylesheetExecutionContext&     executionContext,
            const NodeRefListBase&          selectedNodeList,
            MutableNodeRefList&             sortedNodeList) const;

#else

    void
    transformSelectedChildren(
            StylesheetExecutionContext&     executionContext,
            const ElemTemplateElement*      theTemplate) const;

    void
    transformSelectedChildren(
            StylesheetExecutionContext&     executionContext,
            const ElemTemplateElement*      theTemplate,
            const NodeRefListBase&          sourceNodes,
            NodeRefListBase::size_type      sourceNodesCount) const;

    virtual void
    selectAndSortChildren(
            StylesheetExecutionContext&     executionContext,
            const ElemTemplateElement*      theTemplate,
            NodeSorter*                     sorter,
            int                             selectStackFrameIndex) const;
#endif

    const XPath*            m_selectPattern;

private:

    SortElemsVectorType             m_sortElems;

    SortElemsVectorType::size_type  m_sortElemsCount;

};



XALAN_CPP_NAMESPACE_END



#endif  // XALAN_ELEMFOREACH_HEADER_GUARD

Interpreting class diagrams

Doxygen and GraphViz are used to generate this API documentation from the Xalan-C header files.

Xalan-C++ XSLT Processor Version 1.10 Copyright © 1999-2004 The Apache Software Foundation. All Rights Reserved.