/usr/include/ITK-4.5/itkDOMNodeXMLReader.h is in libinsighttoolkit4-dev 4.5.0-3.
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 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | /*=========================================================================
*
* Copyright Insight Software Consortium
*
* 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.txt
*
* 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.
*
*=========================================================================*/
#ifndef __itkDOMNodeXMLReader_h
#define __itkDOMNodeXMLReader_h
#include "itkDOMNode.h"
#include "itkObject.h"
#include <istream>
namespace itk
{
/**
* \class DOMNodeXMLReader
* \brief Class to read a DOM object from an XML file or an input stream.
*
* This class produces a DOM object, which can be subsequently used to create a
* corresponding user object.
*
* We do not recommend to directly use this class for user object reading, because the user has to handle
* both DOM object generation from the input XML file and user object generation from the intermediate DOM object.
* Users should derive from the DOMReader, because it performs the former step automatically and lets the users
* concentrate on the latter step, thus implementation of such a reader is simplified.
*
* Note: Though this class behaves similar to ProcessObject, it is not derived from ProcessObject. This is
* because the output of this class, i.e. a DOMNode object, is not a DataObject, thus this class cannot
* be connected to an ITK process pipeline.
*
* The following code snippet demonstrates how to read a DOM object from an XML file:
*
* itk::DOMNode::Pointer output_dom_object;
* const char* input_xml_file_name = ...
* itk::DOMNodeXMLReader::Pointer reader = itk::DOMNodeXMLReader::New();
* reader->SetFileName( input_xml_file_name );
* reader->Update();
* output_dom_object = reader->GetOutput();
*
* \sa DOMReader
* \sa DOMNode
*
* \ingroup ITKIOXML
*/
class DOMNodeXMLReader : public Object
{
public:
/** Standard class typedefs. */
typedef DOMNodeXMLReader Self;
typedef Object Superclass;
typedef SmartPointer< Self > Pointer;
typedef SmartPointer< const Self > ConstPointer;
/** Method for creation through the object factory. */
itkNewMacro(Self);
/** Run-time type information (and related methods). */
itkTypeMacro(DOMNodeXMLReader, Object);
typedef DOMNode OutputType;
typedef OutputType::Pointer OutputPointer;
/** Set the input XML filename. */
itkSetStringMacro(FileName);
/** Get the input XML filename. */
itkGetStringMacro(FileName);
/**
* Get/Set The output DOM object will be created automatically, but the user
* can appoint a user DOM object as the output by calling this function.
*/
itkSetObjectMacro( Output, OutputType );
itkGetModifiableObjectMacro(Output, OutputType );
/**
* Function called by Update() or end-users to generate the output DOM object
* from an input stream such as file, string, etc.
*/
void Update( std::istream& is );
/**
* Function called by end-users to generate the output DOM object from the input XML file.
*/
virtual void Update();
/** Callback function -- called from XML parser with start-of-element
* information.
*/
virtual void StartElement( const char* name, const char** atts );
/** Callback function -- called from XML parser when ending tag
* encountered.
*/
virtual void EndElement( const char* name );
/** Callback function -- called from XML parser with the character data
* for an XML element.
*/
virtual void CharacterDataHandler( const char* text, int len );
protected:
DOMNodeXMLReader();
private:
DOMNodeXMLReader(const Self &); //purposely not implemented
void operator=(const Self &); //purposely not implemented
/** Variable to hold the input XML file name. */
std::string m_FileName;
/** Variable to hold the output DOM object, created internally or supplied by the user. */
OutputPointer m_Output;
/** Variable to keep the current context during XML parsing. */
OutputType* m_Context;
};
} // namespace itk
/** The operator ">>" is overloaded such that a DOM object can be conveniently read from an input stream. */
inline std::istream& operator>>( std::istream& is, itk::DOMNode& object )
{
itk::DOMNodeXMLReader::Pointer reader = itk::DOMNodeXMLReader::New();
reader->SetOutput( &object );
reader->Update( is );
return is;
}
#endif // __itkDOMNodeXMLReader_h
|