/// <summary>
/// 指定されたセクションへ指定された名前のリンク文字列を設定します。
/// </summary>
/// <remarks>
/// 同名の値が既に存在する場合は削除されます。
/// </remarks>
/// <param name="section">設定先のセクションです。</param>
/// <param name="name">設定するリンク文字列の名前です。</param>
/// <param name="value">リンク文字列です。</param>
/// <returns>設定に成功した場合はリンク文字列を表すオブジェクト、失敗した場合は<see langword="null"/>を返します。</returns>
/// <exception cref="System.ArgumentNullException"/>
/// <exception cref="CAP.Yencon.Exceptions.InvalidNodeNameException"/>
public static YLink?SetLink(this YSection section, string name, string value)
{
section.EnsureNotNull(nameof(section));
section.RemoveNode(name);
return(section.CreateLink(name, value));
}
/// <summary>
/// 指定されたセクションへ指定された名前の10進数値を設定します。
/// </summary>
/// <remarks>
/// 同名の値が既に存在する場合は削除されます。
/// </remarks>
/// <param name="section">設定先のセクションです。</param>
/// <param name="name">設定する10進数値の名前です。</param>
/// <param name="value">10進数値です。</param>
/// <returns>設定に成功した場合は10進数値を表すオブジェクト、失敗した場合は<see langword="null"/>を返します。</returns>
/// <exception cref="System.ArgumentNullException"/>
/// <exception cref="CAP.Yencon.Exceptions.InvalidNodeNameException"/>
public static YNumber?SetNumber(this YSection section, string name, decimal value)
{
section.EnsureNotNull(nameof(section));
section.RemoveNode(name);
return(section.CreateNumber(name, value));
}
/// <summary>
/// 指定されたセクションへ指定された名前の論理値を設定します。
/// </summary>
/// <remarks>
/// 同名の値が既に存在する場合は削除されます。
/// </remarks>
/// <param name="section">設定先のセクションです。</param>
/// <param name="name">設定する論理値の名前です。</param>
/// <param name="value">論理値です。</param>
/// <returns>設定に成功した場合は論理値を表すオブジェクト、失敗した場合は<see langword="null"/>を返します。</returns>
/// <exception cref="System.ArgumentNullException"/>
/// <exception cref="CAP.Yencon.Exceptions.InvalidNodeNameException"/>
public static YBoolean?SetBoolean(this YSection section, string name, bool value)
{
section.EnsureNotNull(nameof(section));
section.RemoveNode(name);
return(section.CreateBoolean(name, value));
}
/// <summary>
/// 指定されたセクションへ指定された名前の空値を設定します。
/// </summary>
/// <remarks>
/// 同名の値が既に存在する場合は削除されます。
/// </remarks>
/// <param name="section">設定先のセクションです。</param>
/// <param name="name">設定する空値の名前です。</param>
/// <returns>設定に成功した場合は空値を表すオブジェクト、失敗した場合は<see langword="null"/>を返します。</returns>
/// <exception cref="System.ArgumentNullException"/>
/// <exception cref="CAP.Yencon.Exceptions.InvalidNodeNameException"/>
public static YEmpty?SetEmpty(this YSection section, string name)
{
section.EnsureNotNull(nameof(section));
section.RemoveNode(name);
return(section.CreateEmpty(name));
}