DOMNodeList.hpp
上传用户:zhuqijet
上传日期:2013-06-25
资源大小:10074k
文件大小:6k
源码类别:

词法分析

开发平台:

Visual C++

  1. #ifndef DOMNodeList_HEADER_GUARD_
  2. #define DOMNodeList_HEADER_GUARD_
  3. /*
  4.  * The Apache Software License, Version 1.1
  5.  *
  6.  * Copyright (c) 2001-2002 The Apache Software Foundation.  All rights
  7.  * reserved.
  8.  *
  9.  * Redistribution and use in source and binary forms, with or without
  10.  * modification, are permitted provided that the following conditions
  11.  * are met:
  12.  *
  13.  * 1. Redistributions of source code must retain the above copyright
  14.  *    notice, this list of conditions and the following disclaimer.
  15.  *
  16.  * 2. Redistributions in binary form must reproduce the above copyright
  17.  *    notice, this list of conditions and the following disclaimer in
  18.  *    the documentation and/or other materials provided with the
  19.  *    distribution.
  20.  *
  21.  * 3. The end-user documentation included with the redistribution,
  22.  *    if any, must include the following acknowledgment:
  23.  *       "This product includes software developed by the
  24.  *        Apache Software Foundation (http://www.apache.org/)."
  25.  *    Alternately, this acknowledgment may appear in the software itself,
  26.  *    if and wherever such third-party acknowledgments normally appear.
  27.  *
  28.  * 4. The names "Xerces" and "Apache Software Foundation" must
  29.  *    not be used to endorse or promote products derived from this
  30.  *    software without prior written permission. For written
  31.  *    permission, please contact apache@apache.org.
  32.  *
  33.  * 5. Products derived from this software may not be called "Apache",
  34.  *    nor may "Apache" appear in their name, without prior written
  35.  *    permission of the Apache Software Foundation.
  36.  *
  37.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  38.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  39.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  40.  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  41.  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  42.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  43.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  44.  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  45.  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  46.  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  47.  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  48.  * SUCH DAMAGE.
  49.  * ====================================================================
  50.  *
  51.  * This software consists of voluntary contributions made by many
  52.  * individuals on behalf of the Apache Software Foundation, and was
  53.  * originally based on software copyright (c) 2001, International
  54.  * Business Machines, Inc., http://www.ibm.com .  For more information
  55.  * on the Apache Software Foundation, please see
  56.  * <http://www.apache.org/>.
  57.  */
  58. /*
  59.  * $Id: DOMNodeList.hpp,v 1.8 2003/03/07 19:59:08 tng Exp $
  60.  */
  61. #include <xercesc/util/XercesDefs.hpp>
  62. XERCES_CPP_NAMESPACE_BEGIN
  63. class DOMNode;
  64. /**
  65.  * The <code>DOMNodeList</code> interface provides the abstraction of an ordered
  66.  * collection of nodes.  DOMNodeLists are created by DOMDocument::getElementsByTagName(),
  67.  * DOMNode::getChildNodes(),
  68.  *
  69.  * <p>The items in the <code>DOMNodeList</code> are accessible via an integral
  70.  * index, starting from 0.
  71.  *
  72.  * DOMNodeLists are "live", in that any changes to the document tree are immediately
  73.  * reflected in any DOMNodeLists that may have been created for that tree.
  74.  */
  75. class  CDOM_EXPORT DOMNodeList {
  76. protected:
  77.     // -----------------------------------------------------------------------
  78.     //  Hidden constructors
  79.     // -----------------------------------------------------------------------
  80.     /** @name Hidden constructors */
  81.     //@{    
  82.     DOMNodeList() {};
  83.     //@}
  84. private:
  85.     // -----------------------------------------------------------------------
  86.     // Unimplemented constructors and operators
  87.     // -----------------------------------------------------------------------
  88.     /** @name Unimplemented constructors and operators */
  89.     //@{
  90.     DOMNodeList(const DOMNodeList &);
  91.     DOMNodeList & operator = (const DOMNodeList &);
  92.     //@}
  93. public:
  94.     // -----------------------------------------------------------------------
  95.     //  All constructors are hidden, just the destructor is available
  96.     // -----------------------------------------------------------------------
  97.     /** @name Destructor */
  98.     //@{
  99.     /**
  100.      * Destructor
  101.      *
  102.      */
  103.     virtual ~DOMNodeList()  {};
  104.     //@}
  105.     // -----------------------------------------------------------------------
  106.     //  Virtual DOMNodeList interface
  107.     // -----------------------------------------------------------------------
  108.     /** @name Functions introduced in DOM Level 1 */
  109.     //@{
  110.     // -----------------------------------------------------------------------
  111.     //  Getter methods
  112.     // -----------------------------------------------------------------------
  113.     /**
  114.      * Returns the <code>index</code> item in the collection.
  115.      *
  116.      * If <code>index</code> is greater than or equal to the number of nodes in
  117.      * the list, this returns <code>null</code>.
  118.      *
  119.      * @param index Index into the collection.
  120.      * @return The node at the <code>index</code>th position in the
  121.      *   <code>DOMNodeList</code>, or <code>null</code> if that is not a valid
  122.      *   index.
  123.      * @since DOM Level 1
  124.      */
  125.     virtual DOMNode  *item(XMLSize_t index) const = 0;
  126.     /**
  127.      * Returns the number of nodes in the list.
  128.      *
  129.      * The range of valid child node indices is 0 to <code>length-1</code> inclusive.
  130.      * @since DOM Level 1
  131.      */
  132.     virtual XMLSize_t getLength() const = 0;
  133.     //@}
  134. };
  135. XERCES_CPP_NAMESPACE_END
  136. #endif