/usr/include/xercesc/dom/DOMDocumentFragment.hpp is in libxerces-c2-dev 2.8.0+deb1-3build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 | #ifndef DOMDocumentFragment_HEADER_GUARD_
#define DOMDocumentFragment_HEADER_GUARD_
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.
*/
/*
* $Id: DOMDocumentFragment.hpp 568078 2007-08-21 11:43:25Z amassari $
*/
#include <xercesc/util/XercesDefs.hpp>
#include <xercesc/dom/DOMNode.hpp>
XERCES_CPP_NAMESPACE_BEGIN
/**
* DOMDocumentFragment is a "lightweight" or "minimal"
* DOMDocument object.
*
* It is very common to want to be able to
* extract a portion of a document's tree or to create a new fragment of a
* document. Imagine implementing a user command like cut or rearranging a
* document by moving fragments around. It is desirable to have an object
* which can hold such fragments and it is quite natural to use a DOMNode for
* this purpose. While it is true that a <code>DOMDocument</code> object could
* fulfil this role, a <code>DOMDocument</code> object can potentially be a
* heavyweight object, depending on the underlying implementation. What is
* really needed for this is a very lightweight object.
* <code>DOMDocumentFragment</code> is such an object.
* <p>Furthermore, various operations -- such as inserting nodes as children
* of another <code>DOMNode</code> -- may take <code>DOMDocumentFragment</code>
* objects as arguments; this results in all the child nodes of the
* <code>DOMDocumentFragment</code> being moved to the child list of this node.
* <p>The children of a <code>DOMDocumentFragment</code> node are zero or more
* nodes representing the tops of any sub-trees defining the structure of the
* document. <code>DOMDocumentFragment</code> nodes do not need to be
* well-formed XML documents (although they do need to follow the rules
* imposed upon well-formed XML parsed entities, which can have multiple top
* nodes). For example, a <code>DOMDocumentFragment</code> might have only one
* child and that child node could be a <code>DOMText</code> node. Such a
* structure model represents neither an HTML document nor a well-formed XML
* document.
* <p>When a <code>DOMDocumentFragment</code> is inserted into a
* <code>DOMDocument</code> (or indeed any other <code>DOMNode</code> that may take
* children) the children of the <code>DOMDocumentFragment</code> and not the
* <code>DOMDocumentFragment</code> itself are inserted into the
* <code>DOMNode</code>. This makes the <code>DOMDocumentFragment</code> very
* useful when the user wishes to create nodes that are siblings; the
* <code>DOMDocumentFragment</code> acts as the parent of these nodes so that the
* user can use the standard methods from the <code>DOMNode</code> interface,
* such as <code>insertBefore()</code> and <code>appendChild()</code>.
*
* @since DOM Level 1
*/
class CDOM_EXPORT DOMDocumentFragment: public DOMNode {
protected:
// -----------------------------------------------------------------------
// Hidden constructors
// -----------------------------------------------------------------------
/** @name Hidden constructors */
//@{
DOMDocumentFragment() {};
//@}
private:
// -----------------------------------------------------------------------
// Unimplemented constructors and operators
// -----------------------------------------------------------------------
/** @name Unimplemented constructors and operators */
//@{
DOMDocumentFragment(const DOMDocumentFragment &);
DOMDocumentFragment & operator = (const DOMDocumentFragment &);
//@}
public:
// -----------------------------------------------------------------------
// All constructors are hidden, just the destructor is available
// -----------------------------------------------------------------------
/** @name Destructor */
//@{
/**
* Destructor
*
*/
virtual ~DOMDocumentFragment() {};
//@}
};
XERCES_CPP_NAMESPACE_END
#endif
|