141 lines
5.9 KiB
Plaintext
141 lines
5.9 KiB
Plaintext
// ----------------------------------------------------------------------------
|
|
// Copyright (C) 2002-2006 Marcin Kalicinski
|
|
// Copyright (C) 2015 Sebastian Redl
|
|
//
|
|
// Distributed under the Boost Software License, Version 1.0.
|
|
// (See accompanying file LICENSE_1_0.txt or copy at
|
|
// http://www.boost.org/LICENSE_1_0.txt)
|
|
//
|
|
// For more information, see www.boost.org
|
|
// ----------------------------------------------------------------------------
|
|
#ifndef BOOST_PROPERTY_TREE_JSON_PARSER_HPP_INCLUDED
|
|
#define BOOST_PROPERTY_TREE_JSON_PARSER_HPP_INCLUDED
|
|
|
|
#include <boost/property_tree/ptree.hpp>
|
|
#include <boost/property_tree/json_parser/error.hpp>
|
|
#include <boost/property_tree/json_parser/detail/read.hpp>
|
|
#include <boost/property_tree/json_parser/detail/write.hpp>
|
|
|
|
#include <fstream>
|
|
#include <string>
|
|
#include <locale>
|
|
|
|
namespace boost { namespace property_tree { namespace json_parser
|
|
{
|
|
|
|
/**
|
|
* Read JSON from a the given stream and translate it to a property tree.
|
|
* @note Clears existing contents of property tree. In case of error the
|
|
* property tree unmodified.
|
|
* @note Items of JSON arrays are translated into ptree keys with empty
|
|
* names. Members of objects are translated into named keys.
|
|
* @note JSON data can be a string, a numeric value, or one of literals
|
|
* "null", "true" and "false". During parse, any of the above is
|
|
* copied verbatim into ptree data string.
|
|
* @throw json_parser_error In case of error deserializing the property
|
|
* tree.
|
|
* @param stream Stream from which to read in the property tree.
|
|
* @param[out] pt The property tree to populate.
|
|
*/
|
|
template<class Ptree>
|
|
void read_json(std::basic_istream<
|
|
typename Ptree::key_type::value_type
|
|
> &stream,
|
|
Ptree &pt)
|
|
{
|
|
detail::read_json_internal(stream, pt, std::string());
|
|
}
|
|
|
|
/**
|
|
* Read JSON from a the given file and translate it to a property tree.
|
|
* @note Clears existing contents of property tree. In case of error the
|
|
* property tree unmodified.
|
|
* @note Items of JSON arrays are translated into ptree keys with empty
|
|
* names. Members of objects are translated into named keys.
|
|
* @note JSON data can be a string, a numeric value, or one of literals
|
|
* "null", "true" and "false". During parse, any of the above is
|
|
* copied verbatim into ptree data string.
|
|
* @throw json_parser_error In case of error deserializing the property
|
|
* tree.
|
|
* @param filename Name of file from which to read in the property tree.
|
|
* @param[out] pt The property tree to populate.
|
|
* @param loc The locale to use when reading in the file contents.
|
|
*/
|
|
template<class Ptree>
|
|
void read_json(const std::string &filename,
|
|
Ptree &pt,
|
|
const std::locale &loc = std::locale())
|
|
{
|
|
std::basic_ifstream<typename Ptree::key_type::value_type>
|
|
stream(filename.c_str());
|
|
if (!stream)
|
|
BOOST_PROPERTY_TREE_THROW(json_parser_error(
|
|
"cannot open file", filename, 0));
|
|
stream.imbue(loc);
|
|
detail::read_json_internal(stream, pt, filename);
|
|
}
|
|
|
|
/**
|
|
* Translates the property tree to JSON and writes it the given output
|
|
* stream.
|
|
* @note Any property tree key containing only unnamed subkeys will be
|
|
* rendered as JSON arrays.
|
|
* @pre @e pt cannot contain keys that have both subkeys and non-empty data.
|
|
* @throw json_parser_error In case of error translating the property tree
|
|
* to JSON or writing to the output stream.
|
|
* @param stream The stream to which to write the JSON representation of the
|
|
* property tree.
|
|
* @param pt The property tree to tranlsate to JSON and output.
|
|
* @param pretty Whether to pretty-print. Defaults to true for backward
|
|
* compatibility.
|
|
*/
|
|
template<class Ptree>
|
|
void write_json(std::basic_ostream<
|
|
typename Ptree::key_type::value_type
|
|
> &stream,
|
|
const Ptree &pt,
|
|
bool pretty = true)
|
|
{
|
|
write_json_internal(stream, pt, std::string(), pretty);
|
|
}
|
|
|
|
/**
|
|
* Translates the property tree to JSON and writes it the given file.
|
|
* @note Any property tree key containing only unnamed subkeys will be
|
|
* rendered as JSON arrays.
|
|
* @pre @e pt cannot contain keys that have both subkeys and non-empty data.
|
|
* @throw json_parser_error In case of error translating the property tree
|
|
* to JSON or writing to the file.
|
|
* @param filename The name of the file to which to write the JSON
|
|
* representation of the property tree.
|
|
* @param pt The property tree to translate to JSON and output.
|
|
* @param loc The locale to use when writing out to the output file.
|
|
* @param pretty Whether to pretty-print. Defaults to true and last place
|
|
* for backward compatibility.
|
|
*/
|
|
template<class Ptree>
|
|
void write_json(const std::string &filename,
|
|
const Ptree &pt,
|
|
const std::locale &loc = std::locale(),
|
|
bool pretty = true)
|
|
{
|
|
std::basic_ofstream<typename Ptree::key_type::value_type>
|
|
stream(filename.c_str());
|
|
if (!stream)
|
|
BOOST_PROPERTY_TREE_THROW(json_parser_error(
|
|
"cannot open file", filename, 0));
|
|
stream.imbue(loc);
|
|
write_json_internal(stream, pt, filename, pretty);
|
|
}
|
|
|
|
} } }
|
|
|
|
namespace boost { namespace property_tree
|
|
{
|
|
using json_parser::read_json;
|
|
using json_parser::write_json;
|
|
using json_parser::json_parser_error;
|
|
} }
|
|
|
|
#endif
|