utility::json_spirit Namespace Reference

Namespaces
	internal_

Classes
struct	Config_map
struct	Config_vector
struct	Error_position
class	Generator
class	Json_grammer
struct	Multi_pass_iters
struct	Null
struct	Pair_impl
class	Semantic_actions
class	Stream_reader
class	Stream_reader_thrower
class	Value_impl

Typedefs
typedef std::map< std::string, Value >	Mapped_obj
typedef std::map< std::wstring, wValue >	wMapped_obj
typedef Config_vector < std::string >	Config
typedef Config::Value_type	Value
typedef Config::Pair_type	Pair
typedef Config::Object_type	Object
typedef Config::Array_type	Array
typedef Config_vector < std::wstring >	wConfig
typedef wConfig::Value_type	wValue
typedef wConfig::Pair_type	wPair
typedef wConfig::Object_type	wObject
typedef wConfig::Array_type	wArray
typedef Config_map< std::string >	mConfig
typedef mConfig::Value_type	mValue
typedef mConfig::Object_type	mObject
typedef mConfig::Array_type	mArray
typedef Config_map< std::wstring >	wmConfig
typedef wmConfig::Value_type	wmValue
typedef wmConfig::Object_type	wmObject
typedef wmConfig::Array_type	wmArray

Enumerations
enum	Value_type {   obj_type, array_type, str_type, bool_type,   int_type, real_type, null_type }
enum	Output_options { pretty_print = 0x01, raw_utf8 = 0x02, remove_trailing_zeros = 0x04, single_line_arrays = 0x08 }

Functions
bool	read (const std::string &s, Value &value)
bool	read (std::istream &is, Value &value)
bool	read (std::string::const_iterator &begin, std::string::const_iterator end, Value &value)
void	read_or_throw (const std::string &s, Value &value)
void	read_or_throw (std::istream &is, Value &value)
void	read_or_throw (std::string::const_iterator &begin, std::string::const_iterator end, Value &value)
bool	read (const std::wstring &s, wValue &value)
bool	read (std::wistream &is, wValue &value)
bool	read (std::wstring::const_iterator &begin, std::wstring::const_iterator end, wValue &value)
void	read_or_throw (const std::wstring &s, wValue &value)
void	read_or_throw (std::wistream &is, wValue &value)
void	read_or_throw (std::wstring::const_iterator &begin, std::wstring::const_iterator end, wValue &value)
bool	read (const std::string &s, mValue &value)
bool	read (std::istream &is, mValue &value)
bool	read (std::string::const_iterator &begin, std::string::const_iterator end, mValue &value)
void	read_or_throw (const std::string &s, mValue &value)
void	read_or_throw (std::istream &is, mValue &value)
void	read_or_throw (std::string::const_iterator &begin, std::string::const_iterator end, mValue &value)
bool	read (const std::wstring &s, wmValue &value)
bool	read (std::wistream &is, wmValue &value)
bool	read (std::wstring::const_iterator &begin, std::wstring::const_iterator end, wmValue &value)
void	read_or_throw (const std::wstring &s, wmValue &value)
void	read_or_throw (std::wistream &is, wmValue &value)
void	read_or_throw (std::wstring::const_iterator &begin, std::wstring::const_iterator end, wmValue &value)
template<class Iter_type >
bool	is_eq (Iter_type first, Iter_type last, const char *c_str)
template<class Char_type >
Char_type	hex_to_num (const Char_type c)
template<class Char_type , class Iter_type >
Char_type	hex_str_to_char (Iter_type &begin)
template<class Char_type , class Iter_type >
Char_type	unicode_str_to_char (Iter_type &begin)
template<class String_type >
void	append_esc_char_and_incr_iter (String_type &s, typename String_type::const_iterator &begin, typename String_type::const_iterator end)
template<class String_type >
String_type	substitute_esc_chars (typename String_type::const_iterator begin, typename String_type::const_iterator end)
template<class String_type >
String_type	get_str_ (typename String_type::const_iterator begin, typename String_type::const_iterator end)
std::string	get_str (std::string::const_iterator begin, std::string::const_iterator end)
std::wstring	get_str (std::wstring::const_iterator begin, std::wstring::const_iterator end)
template<class String_type , class Iter_type >
String_type	get_str (Iter_type begin, Iter_type end)
template<typename Iter_type >
void	throw_error (spirit_namespace::position_iterator< Iter_type > i, const std::string &reason)
template<typename Iter_type >
void	throw_error (Iter_type, const std::string &reason)
template<class Iter_type , class Value_type >
void	add_posn_iter_and_read_range_or_throw (Iter_type begin, Iter_type end, Value_type &value)
template<class Iter_type , class Value_type >
Iter_type	read_range_or_throw (Iter_type begin, Iter_type end, Value_type &value)
template<class Iter_type , class Value_type >
bool	read_range (Iter_type &begin, Iter_type end, Value_type &value)
template<class String_type , class Value_type >
bool	read_string (const String_type &s, Value_type &value)
template<class String_type , class Value_type >
void	read_string_or_throw (const String_type &s, Value_type &value)
template<class Istream_type , class Value_type >
bool	read_stream (Istream_type &is, Value_type &value)
template<class Istream_type , class Value_type >
void	read_stream_or_throw (Istream_type &is, Value_type &value)
bool	has_value (const mObject &obj, const std::string &name)
mValue	get_value (const mObject &obj, const std::string &name)
mObject	get_mObject (const mObject &obj, const std::string &name)
mArray	get_mArray (const mObject &obj, const std::string &name)
mArray	read_mArray (const std::string &json_string)
mObject	read_mObject (const std::string &json_string)
std::string	get_string (const mObject &obj, const std::string &name)
std::string	get_string_or_empty (const mObject &obj, const std::string &name)
double	get_real (const mObject &obj, const std::string &name)
int	get_int (const mObject &obj, const std::string &name)
template<class Obj_t , class Map_t >
void	obj_to_map (const Obj_t &obj, Map_t &mp_obj)
template<class Obj_t , class Map_t >
void	map_to_obj (const Map_t &mp_obj, Obj_t &obj)
template<class Object_type , class String_type >
const Object_type::value_type::Value_type &	find_value (const Object_type &obj, const String_type &name)
bool	operator== (const Null &, const Null &)
template<class String_type >
String_type	to_str (const char *c_str)
void	write (const Value &value, std::ostream &os, unsigned int options=0)
std::string	write (const Value &value, unsigned int options=0)
void	write (const mValue &value, std::ostream &os, unsigned int options=0)
std::string	write (const mValue &value, unsigned int options=0)
void	write (const wValue &value, std::wostream &os, unsigned int options=0)
void	write (const wmValue &value, std::wostream &os, unsigned int options=0)
void	write_formatted (const Value &value, std::ostream &os)
std::string	write_formatted (const Value &value)
void	write_formatted (const mValue &value, std::ostream &os)
std::string	write_formatted (const mValue &value)
void	write_formatted (const wValue &value, std::wostream &os)
void	write_formatted (const wmValue &value, std::wostream &os)
char	to_hex_char (unsigned int c)
template<class String_type >
String_type	non_printable_to_string (unsigned int c)
template<typename Char_type , class String_type >
bool	add_esc_char (Char_type c, String_type &s)
template<class String_type >
String_type	add_esc_chars (const String_type &s, bool raw_utf8)
template<class Ostream >
void	append_double (Ostream &os, const double d, const int precision)
template<class String_type >
void	erase_and_extract_exponent (String_type &str, String_type &exp)
template<class String_type >
String_type::size_type	find_first_non_zero (const String_type &str)
template<class String_type >
void	remove_trailing (String_type &str)
template<class Value_type , class Ostream_type >
void	write_stream (const Value_type &value, Ostream_type &os, unsigned int options=0)
template<class Value_type >
Value_type::String_type	write_string (const Value_type &value, unsigned int options=0)

Variables
const spirit_namespace::int_parser < boost::int64_t >	int64_p = spirit_namespace::int_parser < boost::int64_t >()
const spirit_namespace::uint_parser < boost::uint64_t >	uint64_p = spirit_namespace::uint_parser< boost::uint64_t >()

Typedef Documentation

typedef Config::Array_type utility::json_spirit::Array

typedef Config_vector< std::string > utility::json_spirit::Config

typedef std::map< std::string, Value > utility::json_spirit::Mapped_obj

typedef mConfig::Array_type utility::json_spirit::mArray

typedef Config_map< std::string > utility::json_spirit::mConfig

typedef mConfig::Object_type utility::json_spirit::mObject

typedef mConfig::Value_type utility::json_spirit::mValue

typedef Config::Object_type utility::json_spirit::Object

typedef Config::Pair_type utility::json_spirit::Pair

typedef Config::Value_type utility::json_spirit::Value

typedef wConfig::Array_type utility::json_spirit::wArray

typedef Config_vector< std::wstring > utility::json_spirit::wConfig

typedef std::map< std::wstring, wValue > utility::json_spirit::wMapped_obj

typedef wmConfig::Array_type utility::json_spirit::wmArray

typedef Config_map< std::wstring > utility::json_spirit::wmConfig

typedef wmConfig::Object_type utility::json_spirit::wmObject

typedef wmConfig::Value_type utility::json_spirit::wmValue

typedef wConfig::Object_type utility::json_spirit::wObject

typedef wConfig::Pair_type utility::json_spirit::wPair

typedef wConfig::Value_type utility::json_spirit::wValue

Enumeration Type Documentation

enum utility::json_spirit::Output_options

Enumerator
pretty_print
raw_utf8
remove_trailing_zeros
single_line_arrays

enum utility::json_spirit::Value_type

Enumerator
obj_type
array_type
str_type
bool_type
int_type
real_type
null_type

Function Documentation

template<typename Char_type , class String_type >

bool utility::json_spirit::add_esc_char	(	Char_type	c,
		String_type &	s
	)

Referenced by add_esc_chars().

template<class String_type >

String_type utility::json_spirit::add_esc_chars	(	const String_type &	s,
		bool	raw_utf8
	)

References add_esc_char(), and basic::options::OptionKeys::cutoutdomain::end.

Referenced by utility::json_spirit::Generator< Value_type, Ostream_type >::output().

template<class Iter_type , class Value_type >

void utility::json_spirit::add_posn_iter_and_read_range_or_throw	(	Iter_type	begin,
		Iter_type	end,
		Value_type &	value
	)

References read_range_or_throw().

Referenced by read_stream_or_throw(), and read_string_or_throw().

template<class Ostream >

void utility::json_spirit::append_double	(	Ostream &	os,
		const double	d,
		const int	precision
	)

Referenced by utility::json_spirit::Generator< Value_type, Ostream_type >::output().

template<class String_type >

void utility::json_spirit::append_esc_char_and_incr_iter	(	String_type &	s,
		typename String_type::const_iterator &	begin,
		typename String_type::const_iterator	end
	)

References begin.

Referenced by substitute_esc_chars().

template<class String_type >

void utility::json_spirit::erase_and_extract_exponent	(	String_type &	str,
		String_type &	exp
	)

Referenced by remove_trailing().

template<class String_type >

String_type::size_type utility::json_spirit::find_first_non_zero

(

const String_type &

str

)

Referenced by remove_trailing().

template<class Object_type , class String_type >

const Object_type::value_type::Value_type& utility::json_spirit::find_value	(	const Object_type &	obj,
		const String_type &	name
	)

int utility::json_spirit::get_int	(	const mObject &	obj,
		const std::string &	name
	)

References utility::json_spirit::Value_impl< Config >::get_int(), get_value(), int_type, utility::json_spirit::Value_impl< Config >::type(), and value.

Referenced by get_real().

mArray utility::json_spirit::get_mArray	(	const mObject &	obj,
		const std::string &	name
	)

References array_type, utility::json_spirit::Value_impl< Config >::get_array(), get_value(), utility::json_spirit::Value_impl< Config >::type(), and value.

mObject utility::json_spirit::get_mObject	(	const mObject &	obj,
		const std::string &	name
	)

References utility::json_spirit::Value_impl< Config >::get_obj(), get_value(), obj_type, utility::json_spirit::Value_impl< Config >::type(), and value.

double utility::json_spirit::get_real	(	const mObject &	obj,
		const std::string &	name
	)

References get_int(), utility::json_spirit::Value_impl< Config >::get_real(), get_value(), int_type, real_type, utility::json_spirit::Value_impl< Config >::type(), and value.

Referenced by numeric::interpolation::spline::CompoundInterpolator::deserialize().

std::string utility::json_spirit::get_str ( std::string::const_iterator  begin, std::string::const_iterator  end  )

inline

References begin, and basic::options::OptionKeys::cutoutdomain::end.

Referenced by get_str().

std::wstring utility::json_spirit::get_str ( std::wstring::const_iterator  begin, std::wstring::const_iterator  end  )

inline

References begin, and basic::options::OptionKeys::cutoutdomain::end.

template<class String_type , class Iter_type >

String_type utility::json_spirit::get_str	(	Iter_type	begin,
		Iter_type	end
	)

References get_str().

template<class String_type >

String_type utility::json_spirit::get_str_	(	typename String_type::const_iterator	begin,
		typename String_type::const_iterator	end
	)

std::string utility::json_spirit::get_string	(	const mObject &	obj,
		const std::string &	name
	)

References utility::json_spirit::Value_impl< Config >::get_str(), get_value(), str_type, utility::json_spirit::Value_impl< Config >::type(), and value.

std::string utility::json_spirit::get_string_or_empty	(	const mObject &	obj,
		const std::string &	name
	)

References utility::json_spirit::Value_impl< Config >::get_str(), get_value(), has_value(), str_type, utility::json_spirit::Value_impl< Config >::type(), and value.

mValue utility::json_spirit::get_value	(	const mObject &	obj,
		const std::string &	name
	)

Referenced by get_int(), get_mArray(), get_mObject(), get_real(), get_string(), get_string_or_empty(), and utility::json_spirit::Generator< Value_type, Ostream_type >::output().

bool utility::json_spirit::has_value	(	const mObject &	obj,
		const std::string &	name
	)

Referenced by get_string_or_empty().

template<class Char_type , class Iter_type >

Char_type utility::json_spirit::hex_str_to_char

(

Iter_type &

begin

)

References hex_to_num().

template<class Char_type >

Char_type utility::json_spirit::hex_to_num

(

const Char_type

c

)

Referenced by hex_str_to_char(), and unicode_str_to_char().

template<class Iter_type >

bool utility::json_spirit::is_eq	(	Iter_type	first,
		Iter_type	last,
		const char *	c_str
	)

Referenced by utility::json_spirit::Semantic_actions< Value_type, Iter_type >::new_false(), utility::json_spirit::Semantic_actions< Value_type, Iter_type >::new_null(), and utility::json_spirit::Semantic_actions< Value_type, Iter_type >::new_true().

template<class Obj_t , class Map_t >

void utility::json_spirit::map_to_obj	(	const Map_t &	mp_obj,
		Obj_t &	obj
	)

template<class String_type >

String_type utility::json_spirit::non_printable_to_string

(

unsigned int

c

)

References to_hex_char().

template<class Obj_t , class Map_t >

void utility::json_spirit::obj_to_map	(	const Obj_t &	obj,
		Map_t &	mp_obj
	)

bool utility::json_spirit::operator== ( const Null &  , const Null &    )

inline

bool utility::json_spirit::read	(	const std::string &	s,
		Value &	value
	)

References read_string().

bool utility::json_spirit::read	(	std::istream &	is,
		Value &	value
	)

References read_stream().

bool utility::json_spirit::read	(	std::string::const_iterator &	begin,
		std::string::const_iterator	end,
		Value &	value
	)

References read_range().

bool utility::json_spirit::read	(	const std::wstring &	s,
		wValue &	value
	)

References read_string().

bool utility::json_spirit::read	(	std::wistream &	is,
		wValue &	value
	)

References read_stream().

bool utility::json_spirit::read	(	std::wstring::const_iterator &	begin,
		std::wstring::const_iterator	end,
		wValue &	value
	)

References read_range().

bool utility::json_spirit::read	(	const std::string &	s,
		mValue &	value
	)

References read_string().

bool utility::json_spirit::read	(	std::istream &	is,
		mValue &	value
	)

References read_stream().

bool utility::json_spirit::read	(	std::string::const_iterator &	begin,
		std::string::const_iterator	end,
		mValue &	value
	)

References read_range().

bool utility::json_spirit::read	(	const std::wstring &	s,
		wmValue &	value
	)

References read_string().

bool utility::json_spirit::read	(	std::wistream &	is,
		wmValue &	value
	)

References read_stream().

bool utility::json_spirit::read	(	std::wstring::const_iterator &	begin,
		std::wstring::const_iterator	end,
		wmValue &	value
	)

References read_range().

mArray utility::json_spirit::read_mArray

(

const std::string &

json_string

)

References array_type, utility::json_spirit::Value_impl< Config >::get_array(), read_or_throw(), utility::json_spirit::Value_impl< Config >::type(), and value.

mObject utility::json_spirit::read_mObject

(

const std::string &

json_string

)

References utility::json_spirit::Value_impl< Config >::get_obj(), obj_type, read_or_throw(), utility::json_spirit::Value_impl< Config >::type(), and value.

void utility::json_spirit::read_or_throw	(	const std::string &	s,
		Value &	value
	)

References read_string_or_throw().

Referenced by read_mArray(), and read_mObject().

void utility::json_spirit::read_or_throw	(	std::istream &	is,
		Value &	value
	)

References read_stream_or_throw().

void utility::json_spirit::read_or_throw	(	std::string::const_iterator &	begin,
		std::string::const_iterator	end,
		Value &	value
	)

References read_range_or_throw().

void utility::json_spirit::read_or_throw	(	const std::wstring &	s,
		wValue &	value
	)

References read_string_or_throw().

void utility::json_spirit::read_or_throw	(	std::wistream &	is,
		wValue &	value
	)

References read_stream_or_throw().

void utility::json_spirit::read_or_throw	(	std::wstring::const_iterator &	begin,
		std::wstring::const_iterator	end,
		wValue &	value
	)

References read_range_or_throw().

void utility::json_spirit::read_or_throw	(	const std::string &	s,
		mValue &	value
	)

References read_string_or_throw().

void utility::json_spirit::read_or_throw	(	std::istream &	is,
		mValue &	value
	)

References read_stream_or_throw().

void utility::json_spirit::read_or_throw	(	std::string::const_iterator &	begin,
		std::string::const_iterator	end,
		mValue &	value
	)

References read_range_or_throw().

void utility::json_spirit::read_or_throw	(	const std::wstring &	s,
		wmValue &	value
	)

References read_string_or_throw().

void utility::json_spirit::read_or_throw	(	std::wistream &	is,
		wmValue &	value
	)

References read_stream_or_throw().

void utility::json_spirit::read_or_throw	(	std::wstring::const_iterator &	begin,
		std::wstring::const_iterator	end,
		wmValue &	value
	)

References read_range_or_throw().

template<class Iter_type , class Value_type >

bool utility::json_spirit::read_range	(	Iter_type &	begin,
		Iter_type	end,
		Value_type &	value
	)

References read_range_or_throw().

Referenced by read(), utility::json_spirit::Stream_reader< Istream_type, Value_type >::read_next(), read_stream(), and read_string().

template<class Iter_type , class Value_type >

Iter_type utility::json_spirit::read_range_or_throw	(	Iter_type	begin,
		Iter_type	end,
		Value_type &	value
	)

References info(), extract_scores_and_constraints::parse(), and throw_error().

Referenced by add_posn_iter_and_read_range_or_throw(), utility::json_spirit::Stream_reader_thrower< Istream_type, Value_type >::read_next(), read_or_throw(), and read_range().

template<class Istream_type , class Value_type >

bool utility::json_spirit::read_stream	(	Istream_type &	is,
		Value_type &	value
	)

References utility::json_spirit::Multi_pass_iters< Istream_type >::begin_, utility::json_spirit::Multi_pass_iters< Istream_type >::end_, and read_range().

Referenced by read().

template<class Istream_type , class Value_type >

void utility::json_spirit::read_stream_or_throw	(	Istream_type &	is,
		Value_type &	value
	)

References add_posn_iter_and_read_range_or_throw(), utility::json_spirit::Multi_pass_iters< Istream_type >::begin_, and utility::json_spirit::Multi_pass_iters< Istream_type >::end_.

Referenced by read_or_throw().

template<class String_type , class Value_type >

bool utility::json_spirit::read_string	(	const String_type &	s,
		Value_type &	value
	)

References begin, read_range(), and value.

Referenced by read().

template<class String_type , class Value_type >

void utility::json_spirit::read_string_or_throw	(	const String_type &	s,
		Value_type &	value
	)

References add_posn_iter_and_read_range_or_throw(), and value.

Referenced by read_or_throw().

template<class String_type >

void utility::json_spirit::remove_trailing

(

String_type &

str

)

References erase_and_extract_exponent(), and find_first_non_zero().

Referenced by utility::json_spirit::Generator< Value_type, Ostream_type >::output().

template<class String_type >

String_type utility::json_spirit::substitute_esc_chars	(	typename String_type::const_iterator	begin,
		typename String_type::const_iterator	end
	)

References append_esc_char_and_incr_iter(), and begin.

template<typename Iter_type >

void utility::json_spirit::throw_error	(	spirit_namespace::position_iterator< Iter_type >	i,
		const std::string &	reason
	)

Referenced by read_range_or_throw(), utility::json_spirit::Json_grammer< Value_type, Iter_type >::throw_not_array(), utility::json_spirit::Json_grammer< Value_type, Iter_type >::throw_not_colon(), utility::json_spirit::Json_grammer< Value_type, Iter_type >::throw_not_object(), utility::json_spirit::Json_grammer< Value_type, Iter_type >::throw_not_pair(), utility::json_spirit::Json_grammer< Value_type, Iter_type >::throw_not_string(), and utility::json_spirit::Json_grammer< Value_type, Iter_type >::throw_not_value().

template<typename Iter_type >

void utility::json_spirit::throw_error	(	Iter_type	,
		const std::string &	reason
	)

char utility::json_spirit::to_hex_char ( unsigned int  c )

inline

Referenced by non_printable_to_string().

template<class String_type >

String_type utility::json_spirit::to_str

(

const char *

c_str

)

References basic::options::OptionKeys::score::fiber_diffraction::p.

template<class Char_type , class Iter_type >

Char_type utility::json_spirit::unicode_str_to_char

(

Iter_type &

begin

)

References hex_to_num().

void utility::json_spirit::write	(	const Value &	value,
		std::ostream &	os,
		unsigned int	options = 0
	)

References write_stream().

Referenced by BuildBindings::BuildRosettaOnWindows().

std::wstring utility::json_spirit::write	(	const Value &	value,
		unsigned int	options = 0
	)

References write_string().

void utility::json_spirit::write	(	const mValue &	value,
		std::ostream &	os,
		unsigned int	options = 0
	)

References write_stream().

std::wstring utility::json_spirit::write	(	const mValue &	value,
		unsigned int	options = 0
	)

References write_string().

void utility::json_spirit::write	(	const wValue &	value,
		std::wostream &	os,
		unsigned int	options = 0
	)

References write_stream().

void utility::json_spirit::write	(	const wmValue &	value,
		std::wostream &	os,
		unsigned int	options = 0
	)

References write_stream().

void utility::json_spirit::write_formatted	(	const Value &	value,
		std::ostream &	os
	)

References pretty_print, and write_stream().

std::wstring utility::json_spirit::write_formatted

(

const Value &

value

)

References pretty_print, and write_string().

void utility::json_spirit::write_formatted	(	const mValue &	value,
		std::ostream &	os
	)

References pretty_print, and write_stream().

std::wstring utility::json_spirit::write_formatted

(

const mValue &

value

)

References pretty_print, and write_string().

void utility::json_spirit::write_formatted	(	const wValue &	value,
		std::wostream &	os
	)

References pretty_print, and write_stream().

void utility::json_spirit::write_formatted	(	const wmValue &	value,
		std::wostream &	os
	)

References pretty_print, and write_stream().

template<class Value_type , class Ostream_type >

void utility::json_spirit::write_stream	(	const Value_type &	value,
		Ostream_type &	os,
		unsigned int	options = 0
	)

References options, and value.

Referenced by write(), write_formatted(), and write_string().

template<class Value_type >

Value_type::String_type utility::json_spirit::write_string	(	const Value_type &	value,
		unsigned int	options = 0
	)

References options, and write_stream().

Referenced by write(), and write_formatted().

Variable Documentation

const spirit_namespace::int_parser< boost::int64_t > utility::json_spirit::int64_p = spirit_namespace::int_parser < boost::int64_t >()

Referenced by utility::json_spirit::Json_grammer< Value_type, Iter_type >::definition< ScannerT >::definition().

const spirit_namespace::uint_parser< boost::uint64_t > utility::json_spirit::uint64_p = spirit_namespace::uint_parser< boost::uint64_t >()

Referenced by utility::json_spirit::Json_grammer< Value_type, Iter_type >::definition< ScannerT >::definition().