| Home | Libraries | People | FAQ | More

## Function template read_xml

boost::property_tree::xml_parser::read_xml

## Synopsis

    // In header: <boost/property_tree/xml_parser.hpp>

    template<typename Ptree>
      void read_xml(const std::string & filename, Ptree & pt, int flags = 0,
                    const std::locale & loc = std::locale());

## Description

Reads XML from a file using the given locale and translates it to property tree.

| Note
Clears existing contents of property tree. In case of error the property tree unmodified.

| Note
XML attributes are placed under keys named `<xmlattr>`.

Parameters: |

`filename` | The file from which to read in the property tree.
`flags` | Flags controlling the bahviour of the parser. The following flags are supported:

- `no_concat_text` <ndash></ndash> Prevents concatenation of text nodes into datastring of property tree. Puts them in separate `<xmltext>` strings instead.

- `no_comments` <ndash></ndash> Skip XML comments.

`loc` | The locale to use when reading in the file contents.
`pt` | The property tree to populate.

Throws: | xml_parser_error In case of error deserializing the property tree.