zhangyiss/toml11
1
0
Fork 0
mirror of https://github.com/ToruNiina/toml11.git synced 2025-09-18 02:08:09 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
Files
044a66210d59a2d2f907ccdefe633b3b675d3059
toml11/docs/content.ja/docs/reference/value.md
ToruNiina 044a66210d doc: add reference about try_at
2024-06-26 00:34:54 +09:00

29 KiB
Raw Blame History

+++ title = "value.hpp" type = "docs" +++

value.hpp

value.hppでは、basic_valueが定義されます。

toml::basic_value

basic_valueは、TOMLの値を格納するクラスです。

namespace toml
{
template <class TypeConfig>
class basic_value;

// 以下はtypes.hppで定義される
// using value = basic_value<type_config>;
// using table = typename basic_value<type_config>::table_type;
// using array = typename basic_value<type_config>::array_type;

template<typename TC>
bool operator==(const basic_value<TC>&, const basic_value<TC>&);
template<typename TC>
bool operator!=(const basic_value<TC>&, const basic_value<TC>&);
template<typename TC>
bool operator< (const basic_value<TC>&, const basic_value<TC>&);
template<typename TC>
bool operator<=(const basic_value<TC>&, const basic_value<TC>&);
template<typename TC>
bool operator> (const basic_value<TC>&, const basic_value<TC>&);
template<typename TC>
bool operator>=(const basic_value<TC>&, const basic_value<TC>&);
} //toml

メンバ型

以下のメンバ型が定義されます。

TypeConfigを使って、メンバ型を変更することができます。

参考： [types.hpp]({{<ref "types.md">}})

名前 定義
char_type typename TypeConfig::char_type
key_type typename TypeConfig::string_type
value_type basic_value<TypeConfig>
boolean_type typename TypeConfig::boolean_type
integer_type typename TypeConfig::integer_type
floating_type typename TypeConfig::floating_type
string_type typename TypeConfig::string_type
local_time_type toml::local_time
local_date_type toml::local_date
local_datetime_type toml::local_datetime
offset_datetime_type toml::offset_datetime
array_type typename TypeConfig::template array_type<value_type>
table_type typename TypeConfig::template table_type<key_type, value_type>
comment_type typename TypeConfig::comment_type

メンバ関数

デフォルトコンストラクタ

basic_value() noexcept

空のtoml::valueを構築します。

構築されたtoml::valueは空になります。

コピー・ムーブコンストラクタ

basic_value(const basic_value& v)
basic_value(basic_value&& v)

値、フォーマット情報、コメント、ファイル領域の全ての情報をコピー・ムーブします。

コピー・ムーブコンストラクタ（コメント指定）

basic_value(basic_value v, std::vector<std::string> com)

コメントを上書きしながらコピー・ムーブします。

変換コンストラクタ

template<typename TI>
basic_value(basic_value<TI> other)
template<typename TI>
basic_value(basic_value<TI> other, std::vector<std::string> com)

異なるtype_configを持つbasic_valueからコピー・ムーブします。

コンストラクタ (boolean)

basic_value(boolean_type x)
basic_value(boolean_type x, boolean_format_info fmt)
basic_value(boolean_type x, std::vector<std::string> com)
basic_value(boolean_type x, boolean_format_info fmt, std::vector<std::string> com)

boolと、そのフォーマット情報、コメントを受け取って構築します。

コンストラクタ (integer)

basic_value(integer_type x)
basic_value(integer_type x, integer_format_info fmt)
basic_value(integer_type x, std::vector<std::string> com)
basic_value(integer_type x, integer_format_info fmt, std::vector<std::string> com)

integerと、そのフォーマット情報、コメントを受け取って構築します。

コンストラクタ(floating)

template<typename T, /* T は std::is_floating_point<T> を満たす */>
basic_value(T x)
template<typename T, /* T は std::is_floating_point<T> を満たす */>
basic_value(T x, floating_format_info fmt)
template<typename T, /* T は std::is_floating_point<T> を満たす */>
basic_value(T x, std::vector<std::string> com)
template<typename T, /* T は std::is_floating_point<T> を満たす */>
basic_value(T x, floating_format_info fmt, std::vector<std::string> com)

floatingと、そのフォーマット情報、コメントを受け取って構築します。

コンストラクタ(string)

basic_value(string_type x)
basic_value(string_type x, string_format_info fmt)
basic_value(string_type x, std::vector<std::string> com)
basic_value(string_type x, string_format_info fmt, std::vector<std::string> com)

basic_value(const string_type::value_type* x)
basic_value(const string_type::value_type* x, string_format_info fmt)
basic_value(const string_type::value_type* x, std::vector<std::string> com)
basic_value(const string_type::value_type* x, string_format_info fmt, std::vector<std::string> com)

// C++17以降
basic_value(string_view_type x)
basic_value(string_view_type x, string_format_info fmt)
basic_value(string_view_type x, std::vector<std::string> com)
basic_value(string_view_type x, string_format_info fmt, std::vector<std::string> com)

stringと、そのフォーマット情報、コメントを受け取って構築します。

string_view_typeは、string_typeと同じvalue_typeとtraits_typeを持ちます。

コンストラクタ(local_date)

basic_value(local_date_type x)
basic_value(local_date_type x, local_date_format_info fmt)
basic_value(local_date_type x, std::vector<std::string> com)
basic_value(local_date_type x, local_date_format_info fmt, std::vector<std::string> com)

local_date_typeと、そのフォーマット情報、コメントを受け取って構築します。

コンストラクタ(local_time)

basic_value(local_time_type x)
basic_value(local_time_type x, local_time_format_info fmt)
basic_value(local_time_type x, std::vector<std::string> com)
basic_value(local_time_type x, local_time_format_info fmt, std::vector<std::string> com)

template<typename Rep, typename Period>
basic_value(const std::chrono::duration<Rep, Period>& x)
template<typename Rep, typename Period>
basic_value(const std::chrono::duration<Rep, Period>& x, local_time_format_info fmt)
template<typename Rep, typename Period>
basic_value(const std::chrono::duration<Rep, Period>& x, std::vector<std::string> com)
template<typename Rep, typename Period>
basic_value(const std::chrono::duration<Rep, Period>& x, local_time_format_info fmt, std::vector<std::string> com)

local_time_typeと、そのフォーマット情報、コメントを受け取って構築します。

std::chrono::durationは、00:00:00からの時間幅として構築します。

コンストラクタ(local_datetime)

basic_value(local_datetime_type x)
basic_value(local_datetime_type x, local_date_format_info fmt)
basic_value(local_datetime_type x, std::vector<std::string> com)
basic_value(local_datetime_type x, local_date_format_info fmt, std::vector<std::string> com)

local_datetime_typeと、そのフォーマット情報、コメントを受け取って構築します。

コンストラクタ(offset_datetime)

basic_value(offset_datetime_type x)
basic_value(offset_datetime_type x, offset_date_format_info fmt)
basic_value(offset_datetime_type x, std::vector<std::string> com)
basic_value(offset_datetime_type x, offset_date_format_info fmt, std::vector<std::string> com)

basic_value(std::chrono::system_clock::time_point x)
basic_value(std::chrono::system_clock::time_point x, offset_date_format_info fmt)
basic_value(std::chrono::system_clock::time_point x, std::vector<std::string> com)
basic_value(std::chrono::system_clock::time_point x, offset_date_format_info fmt, std::vector<std::string> com)

offset_datetime_typeと、そのフォーマット情報、コメントを受け取って構築します。

std::chrono::system_clock::time_pointの場合、それが指す時点として構築します。

コンストラクタ(array)

basic_value(array_type x)
basic_value(array_type x, integer_format_info fmt)
basic_value(array_type x, std::vector<std::string> com)
basic_value(array_type x, integer_format_info fmt, std::vector<std::string> com)

template<typename T, /* T is array-like */>
basic_value(T x)
template<typename T, /* T is array-like */>
basic_value(T x, array_format_info fmt)
template<typename T, /* T is array-like */>
basic_value(T x, std::vector<std::string> com)
template<typename T, /* T is array-like */>
basic_value(T x, array_format_info fmt, std::vector<std::string> com)

arrayと、そのフォーマット情報、コメントを受け取って構築します。

array-likeは、以下の条件を満たす型です。

  • T::iterator を持つ。
  • T::value_type を持つ。
  • T::key_type を持たない。
  • T::mapped_type を持たない。
  • std::string ではない。
  • std::string_view ではない。(C++17以降)

コンストラクタ(table)

basic_value(table_type x)
basic_value(table_type x, integer_format_info fmt)
basic_value(table_type x, std::vector<std::string> com)
basic_value(table_type x, integer_format_info fmt, std::vector<std::string> com)

template<typename T, /* T is table-like */>
basic_value(T x)
template<typename T, /* T is table-like */>
basic_value(T x, table_format_info fmt)
template<typename T, /* T is table-like */>
basic_value(T x, std::vector<std::string> com)
template<typename T, /* T is table-like */>
basic_value(T x, table_format_info fmt, std::vector<std::string> com)

tableと、そのフォーマット情報、コメントを受け取って構築します。

table-likeは、以下の条件を満たす型です。

  • T::iterator を持つ。
  • T::value_type を持つ。
  • T::key_type を持つ。
  • T::mapped_type を持つ。

コンストラクタ(user-defined)

template<typename T /* toml::into<T>が定義されていること */>
basic_value(const T& ud);

template<typename T /* toml::into<T>が定義されていること */>
basic_value(const T& ud, std::vector<std::string> com);

template<typename T /* into<T>は定義されておらず、T{}.into_toml()が存在すること */>
basic_value(const T& ud);

template<typename T /* into<T>は定義されておらず、T{}.into_toml()が存在すること */>
basic_value(const T& ud, std::vector<std::string> com);

toml::into<T> が定義されていた場合、 toml::into<T>(ud) の結果から構築します。

toml::into<T> が定義されておらず、 T に into_toml() メンバ関数が定義されていた場合、 ud.into_toml()の結果から構築します。

operator=(basic_value)

basic_value& operator=(const basic_value& v)
basic_value& operator=(basic_value&& v)
template<typename TI>
basic_value& operator=(basic_value<TI> other)

右辺のbasic_valueを代入します。

operator=(T)

template<typename T>
basic_value& operator=(T x)

Tに対応する値を代入します。

source_locationの指す内容は破棄されます。

もし同じ型の値を持っていたなら、元のフォーマット情報が保持されます。

is<T>()

bool is<T>() const noexcept

条件

Tは厳密にTOML型であること。つまり、値に対応するtoml::value::xxx_typeのいずれかであること。

戻り値

格納している型がTと一致した場合trueを、そうでない場合はfalseを返します。

is(toml::value_t)

bool is(toml::value_t t) const noexcept

戻り値

格納している型のタグがtと一致した場合trueを、そうでない場合はfalseを返します。

is_xxx()

bool is_boolean()         const noexcept;
bool is_integer()         const noexcept;
bool is_floating()        const noexcept;
bool is_string()          const noexcept;
bool is_offset_datetime() const noexcept;
bool is_local_datetime()  const noexcept;
bool is_local_date()      const noexcept;
bool is_local_time()      const noexcept;
bool is_array()           const noexcept;
bool is_table()           const noexcept;

戻り値

格納している型がその型である場合trueを、そうでない場合はfalseを返します。

is_empty()

bool is_empty()   const noexcept;

戻り値

デフォルト構築され値が代入されていない場合trueを、そうでない場合はfalseを返します。

is_array_of_tables()

bool is_array_of_tables() const noexcept;

戻り値

格納している型が配列であり、空ではなく、全要素がテーブルの場合はtrueを、そうでない場合はfalseを返します。

type()

toml::value_t type() const noexcept

戻り値

格納している型に対応するタグを返します。

as_xxx()

boolean_type         const& as_boolean        () const;
integer_type         const& as_integer        () const;
floating_type        const& as_floating       () const;
string_type          const& as_string         () const;
offset_datetime_type const& as_offset_datetime() const;
local_datetime_type  const& as_local_datetime () const;
local_date_type      const& as_local_date     () const;
local_time_type      const& as_local_time     () const;
array_type           const& as_array          () const;
table_type           const& as_table          () const;

boolean_type        & as_boolean        ();
integer_type        & as_integer        ();
floating_type       & as_floating       ();
string_type         & as_string         ();
offset_datetime_type& as_offset_datetime();
local_datetime_type & as_local_datetime ();
local_date_type     & as_local_date     ();
local_time_type     & as_local_time     ();
array_type          & as_array          ();
table_type          & as_table          ();

戻り値

指定された型への参照を返します。

例外

格納されている値の型が指定と異なる場合、toml::type_errorを送出します。

as_xxx(std::nothrow)

std::nothrowオブジェクトを渡して呼び出します。

boolean_type         const& as_boolean        (const std::nothrow_t&) const noexcept;
integer_type         const& as_integer        (const std::nothrow_t&) const noexcept;
floating_type        const& as_floating       (const std::nothrow_t&) const noexcept;
string_type          const& as_string         (const std::nothrow_t&) const noexcept;
offset_datetime_type const& as_offset_datetime(const std::nothrow_t&) const noexcept;
local_datetime_type  const& as_local_datetime (const std::nothrow_t&) const noexcept;
local_date_type      const& as_local_date     (const std::nothrow_t&) const noexcept;
local_time_type      const& as_local_time     (const std::nothrow_t&) const noexcept;
array_type           const& as_array          (const std::nothrow_t&) const noexcept;
table_type           const& as_table          (const std::nothrow_t&) const noexcept;

boolean_type        & as_boolean        (const std::nothrow_t&) noexcept;
integer_type        & as_integer        (const std::nothrow_t&) noexcept;
floating_type       & as_floating       (const std::nothrow_t&) noexcept;
string_type         & as_string         (const std::nothrow_t&) noexcept;
offset_datetime_type& as_offset_datetime(const std::nothrow_t&) noexcept;
local_datetime_type & as_local_datetime (const std::nothrow_t&) noexcept;
local_date_type     & as_local_date     (const std::nothrow_t&) noexcept;
local_time_type     & as_local_time     (const std::nothrow_t&) noexcept;
array_type          & as_array          (const std::nothrow_t&) noexcept;
table_type          & as_table          (const std::nothrow_t&) noexcept;

戻り値

指定された型への参照を返します。

備考

格納されている値の型が指定と異なる場合、未定義動作となります。

as_xxx_fmt()

フォーマット情報にアクセスします。

boolean_format_info        & as_boolean_fmt        ();
integer_format_info        & as_integer_fmt        ();
floating_format_info       & as_floating_fmt       ();
string_format_info         & as_string_fmt         ();
offset_datetime_format_info& as_offset_datetime_fmt();
local_datetime_format_info & as_local_datetime_fmt ();
local_date_format_info     & as_local_date_fmt     ();
local_time_format_info     & as_local_time_fmt     ();
array_format_info          & as_array_fmt          ();
table_format_info          & as_table_fmt          ();

boolean_format_info         const& as_boolean_fmt        () const;
integer_format_info         const& as_integer_fmt        () const;
floating_format_info        const& as_floating_fmt       () const;
string_format_info          const& as_string_fmt         () const;
offset_datetime_format_info const& as_offset_datetime_fmt() const;
local_datetime_format_info  const& as_local_datetime_fmt () const;
local_date_format_info      const& as_local_date_fmt     () const;
local_time_format_info      const& as_local_time_fmt     () const;
array_format_info           const& as_array_fmt          () const;
table_format_info           const& as_table_fmt          () const;

戻り値

指定された型のフォーマット情報を持つ構造体への参照を返します。

例外

格納されている値の型が指定と異なる場合、toml::type_errorを送出します。

as_xxx_fmt(std::nothrow)

std::nothrowオブジェクトを渡して呼び出します。

boolean_format_info        & as_boolean_fmt        (const std::nothrow_t&) noexcept;
integer_format_info        & as_integer_fmt        (const std::nothrow_t&) noexcept;
floating_format_info       & as_floating_fmt       (const std::nothrow_t&) noexcept;
string_format_info         & as_string_fmt         (const std::nothrow_t&) noexcept;
offset_datetime_format_info& as_offset_datetime_fmt(const std::nothrow_t&) noexcept;
local_datetime_format_info & as_local_datetime_fmt (const std::nothrow_t&) noexcept;
local_date_format_info     & as_local_date_fmt     (const std::nothrow_t&) noexcept;
local_time_format_info     & as_local_time_fmt     (const std::nothrow_t&) noexcept;
array_format_info          & as_array_fmt          (const std::nothrow_t&) noexcept;
table_format_info          & as_table_fmt          (const std::nothrow_t&) noexcept;

boolean_format_info         const& as_boolean_fmt        (const std::nothrow_t&) const noexcept;
integer_format_info         const& as_integer_fmt        (const std::nothrow_t&) const noexcept;
floating_format_info        const& as_floating_fmt       (const std::nothrow_t&) const noexcept;
string_format_info          const& as_string_fmt         (const std::nothrow_t&) const noexcept;
offset_datetime_format_info const& as_offset_datetime_fmt(const std::nothrow_t&) const noexcept;
local_datetime_format_info  const& as_local_datetime_fmt (const std::nothrow_t&) const noexcept;
local_date_format_info      const& as_local_date_fmt     (const std::nothrow_t&) const noexcept;
local_time_format_info      const& as_local_time_fmt     (const std::nothrow_t&) const noexcept;
array_format_info           const& as_array_fmt          (const std::nothrow_t&) const noexcept;
table_format_info           const& as_table_fmt          (const std::nothrow_t&) const noexcept;

戻り値

指定された型のフォーマット情報を持つ構造体への参照を返します。

備考

格納されている値の型が指定と異なる場合、未定義動作となります。

at(key)

value_type&       at(const key_type& key);
value_type const& at(const key_type& key) const;

戻り値

今のvalueをtableにキャストしたあと、keyによって指定される要素を返します。

例外

もし格納している値がtableではなかった場合、toml::type_errorを送出します。

もし格納しているtableが指定された要素を持っていなかった場合、std::out_of_rangeを送出します。

try_at(key)

result<std::reference_wrapper<value_type>,       error_info> try_at(const key_type& key)       noexcept;
result<std::reference_wrapper<const value_type>, error_info> try_at(const key_type& key) const noexcept;

戻り値

今のvalueをtableにキャストしたあと、keyによって指定される要素を返します。

成功した場合、その要素への参照を持つreference_wrapperを返します。

失敗した場合、 type_error または out_of_range に対応する error_info を返します。

例外

投げません。

operator[](key)

value_type& operator[](const key_type& k);
戻り値

今のvalueをtableにキャストしたあと、keyによって指定される要素への参照です。

もしkeyによって指定される要素が存在しない場合、デフォルト構築されます。

例外

もし格納している値がtableではなかった場合、toml::type_errorを送出します。

count(key)

std::size_t count(const key_type& key) const;

戻り値

今のvalueをtableにキャストしたあと、keyに対応する要素が含まれていれば1、そうでなければ0を返します。

例外

もし格納している値がtableではなかった場合、toml::type_errorを送出します。

contains(key)

bool contains(const key_type& key) const;

戻り値

今のvalueをtableにキャストしたあと、keyに対応する要素が含まれていればtrue、そうでなければfalseを返します。

例外

もし格納している値がtableではなかった場合、toml::type_errorを送出します。

at(idx)

value_type&       at(const std::size_t idx);
value_type const& at(const std::size_t idx) const;

戻り値

今のvalueをarrayにキャストしたあと、idxによって指定される要素を返します。

例外

もし格納している値がarrayではなかった場合、toml::type_errorを送出します。

もし格納しているarrayが指定された要素を持っていなかった場合、std::out_of_rangeを送出します。

try_at(idx)

result<std::reference_wrapper<value_type>,       error_info> try_at(const std::size_t idx)       noexcept;
result<std::reference_wrapper<const value_type>, error_info> try_at(const std::size_t idx) const noexcept;

戻り値

今のvalueをarrayにキャストしたあと、idxによって指定される要素を返します。

成功した場合、その要素への参照を持つreference_wrapperを返します。

失敗した場合、 type_error または out_of_range に対応する error_info を返します。

例外

投げません。

operator[](idx)

value_type&       operator[](const std::size_t idx)       noexcept;
value_type const& operator[](const std::size_t idx) const noexcept;

戻り値

今のvalueをarrayにキャストしたあと、idxによって指定される要素への参照を返します。

備考

一切のチェックを行いません。

もし格納している値がarrayではなかった場合、あるいはidxによって指定される要素が存在しない場合、未定義動作となります。

push_back(value)

void push_back(const value_type& x);
void push_back(value_type&& x);

valueをarrayにキャストしたのち、そのarrayに対してpush_backを実行します。

戻り値

なし。

例外

格納している値がarrayではなかった場合、toml::type_errorを送出します。

emplace_back(args...)

template<typename ... Ts>
value_type& emplace_back(Ts&& ... args)

valueをarrayにキャストしたのち、そのarrayに対してemplace_backを実行します。

戻り値

構築した値への参照。

例外

格納している値がarrayではなかった場合、toml::type_errorを送出します。

size()

std::size_t size() const;

戻り値

今のvalueをarray、string、tableのどれかにキャストしたあと、その要素数を返します。 stringの場合、文字数を返します。

例外

格納している値がarray, string, tableのどれでもなかった場合、toml::type_errorを送出します。

location()

source_location location() const;

戻り値

そのvalueが定義されたTOML文書内の位置を表すsource_locationオブジェクトを返します。

もしTOML文書のパースによって構築されたものでない場合、どこも指示さないsource_locationを返します。

comments()

comment_type const& comments() const noexcept;
comment_type&       comments()       noexcept;

戻り値

コメント用コンテナへの参照を返します。

非メンバ関数

operator==

template<typename TC>
bool operator==(const basic_value<TC>&, const basic_value<TC>&);

以下を満たすとき、2つのbasic_value<T>は同値となります。

  • TOML型が同一
  • 含む値が同一
  • コメントがバイト単位で同一

operator!=

template<typename TC>
bool operator!=(const basic_value<TC>& lhs, const basic_value<TC>& rhs)
{
    return !(lhs == rhs);
}

operator<

array_typeとtable_typeがoperator<を持っている場合のみ定義されます。

template<typename TC>
bool operator<(const basic_value<TC>&, const basic_value<TC>&);

以下の順番で比較されます。

  1. TOML型
  2. TOML型が同一の場合、その値
  3. TOML型とその値が同一の場合、コメント

TOML型は、以下の順に小さい値を持ちます。

  1. toml::value_t::empty
  2. toml::value_t::boolean
  3. toml::value_t::integer
  4. toml::value_t::floating
  5. toml::value_t::string
  6. toml::value_t::offset_datetime
  7. toml::value_t::local_datetime
  8. toml::value_t::local_date
  9. toml::value_t::local_time
  10. toml::value_t::array
  11. toml::value_t::table

operator<=

array_typeとtable_typeがoperator<を持っている場合のみ定義されます。

template<typename TC>
bool operator<=(const basic_value<TC>& lhs, const basic_value<TC>& rhs)
{
    return (lhs < rhs) || (lhs == rhs);
}

operator>

array_typeとtable_typeがoperator<を持っている場合のみ定義されます。

template<typename TC>
bool operator>(const basic_value<TC>& lhs, const basic_value<TC>& rhs)
{
    return !(lhs <= rhs);
}

operator>=

array_typeとtable_typeがoperator<を持っている場合のみ定義されます。

template<typename TC>
bool operator>=(const basic_value<TC>& lhs, const basic_value<TC>& rhs)
{
    return !(lhs < rhs);
}

toml::type_error

型エラーの際に送出される例外です。

型エラーが生じた値の位置情報が格納されています。

struct type_error final : public ::toml::exception
{
  public:
    type_error(std::string what_arg, source_location loc);
    ~type_error() noexcept override = default;

    const char* what() const noexcept override;

    source_location const& location() const noexcept;
};

toml::make_error_info

template<typename TC, typename ... Ts>
error_info make_error_info(
    std::string title, const basic_value<TC>& v, std::string msg, Ts&& ... tail);

basic_value の location() を呼び出して、その source_location を [make_error_info]({{<ref "docs/reference/error_info#make_error_info">}}) に渡して error_info を作成します。

詳しくは [error_info]({{<ref "docs/reference/error_info">}}) を参照してください。

toml::format_error

template<typename TC, typename ... Ts>
std::string format_error(std::string title,
                         const basic_value<TC>& v, std::string msg, Ts&& ... tail);

basic_value の location() を呼び出して、その source_location を [format_error]({{<ref "docs/reference/error_info#format_error">}}) に渡して error_info を作成し、それを文字列化して返します。

詳しくは [error_info]({{<ref "docs/reference/error_info">}}) を参照してください。

関連項目

  • [comments.hpp]({{<ref "comments.md">}})
  • [source_location.hpp]({{<ref "source_location.md">}})
  • [types.hpp]({{<ref "types.md">}})
  • [visit.hpp]({{<ref "visit.md">}})