Teuchos - Trilinos Tools Package  Version of the Day
Teuchos_XMLInputSource.cpp
1 // @HEADER
2 // ***********************************************************************
3 //
4 // Teuchos: Common Tools Package
5 // Copyright (2004) Sandia Corporation
6 //
7 // Under terms of Contract DE-AC04-94AL85000, there is a non-exclusive
8 // license for use of this work by or on behalf of the U.S. Government.
9 //
10 // Redistribution and use in source and binary forms, with or without
11 // modification, are permitted provided that the following conditions are
12 // met:
13 //
14 // 1. Redistributions of source code must retain the above copyright
15 // notice, this list of conditions and the following disclaimer.
16 //
17 // 2. Redistributions in binary form must reproduce the above copyright
18 // notice, this list of conditions and the following disclaimer in the
19 // documentation and/or other materials provided with the distribution.
20 //
21 // 3. Neither the name of the Corporation nor the names of the
22 // contributors may be used to endorse or promote products derived from
23 // this software without specific prior written permission.
24 //
25 // THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY
26 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28 // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE
29 // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
30 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
31 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
32 // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
33 // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
34 // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
35 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36 //
37 // Questions? Contact Michael A. Heroux (maherou@sandia.gov)
38 //
39 // ***********************************************************************
40 // @HEADER
41 
44 
45 
46 #ifdef HAVE_TEUCHOS_EXPAT
48 # define EXPAT_BUFSIZE 8192
49 #else
50 # include "Teuchos_XMLParser.hpp"
51 #endif
52 
53 using namespace Teuchos;
54 
56 {
57 
58 #ifdef HAVE_TEUCHOS_EXPAT
59 
61 
62  XML_Parser parser = XML_ParserCreate(NULL);
63 
64  XML_SetElementHandler(parser, expatStartElementHandler,
65  expatEndElementHandler);
66 
67  XML_SetCharacterDataHandler(parser, expatCharacterDataHandler);
68 
69  XML_SetUserData(parser, (void*) &(*handler));
70 
72 
73  bool done = false;
74  unsigned int bufsize = EXPAT_BUFSIZE;
75  unsigned char buf[EXPAT_BUFSIZE];
76 
77  while (!done)
78  {
79  unsigned int nRead = s->readBytes(buf, bufsize);
80  if (nRead < bufsize)
81  {
82  done = true;
83  }
84  XML_Parse(parser, (char*) buf, bufsize, done);
85  }
86 
87  return handler->getObject();
88 
89 #else
90 
91  XMLParser parser(stream());
92 
93  return parser.parse();
94 
95 #endif
96 
97 }
98 
99 
Defines a class for assembling an XMLObject from XML input.
XMLObject parse()
Consume the XMLInputStream to build an XMLObject.
XMLParser consumes characters from an XMLInputStream object, parsing the XML and using a TreeBuilding...
TEUCHOS_DEPRECATED RCP< T > rcp(T *p, Dealloc_T dealloc, bool owns_mem)
Deprecated.
virtual unsigned int readBytes(unsigned char *const toFill, const unsigned int maxToRead)=0
Read up to maxToRead bytes from the stream.
Representation of an XML data tree. XMLObject is a ref-counted handle to a XMLObjectImplem object...
Expat adapter for the TreeBuildingXMLHandler.
A base class for defining a source of XML input.
XMLObject getObject() const
Get an object by invoking the TreeBuildingXMLHandler on the input data.
The Teuchos namespace contains all of the classes, structs and enums used by Teuchos, as well as a number of utility routines.
const XMLObject & getObject() const
Retrieve the entire XML tree.
TreeBuildingXMLHandler assembles a XMLObject from your XML input.
Smart reference counting pointer class for automatic garbage collection.
virtual RCP< XMLInputStream > stream() const =0
Virtual input source interface.
A class providing a simple XML parser. Methods can be overloaded to exploit external XML parsing libr...