/// <summary>
/// 指定されたセクションに新しい64ビット符号無し整数値を作成し追加します。
/// </summary>
/// <param name="section">新しい64ビット符号無し整数値の保存先のセクションです。</param>
/// <param name="name">新しい64ビット符号無し整数値の名前です。</param>
/// <param name="value">64ビット符号無し整数値です。</param>
/// <returns>
/// 新しい64ビット符号無し整数値を表すオブジェクトです。
/// <paramref name="name"/>が既に存在するノードと一致した場合、
/// またはサポートされない場合は<see langword="null"/>を返します。
/// </returns>
/// <exception cref="System.ArgumentNullException"/>
/// <exception cref="CAP.Yencon.Exceptions.InvalidNodeNameException"/>
public static YNumber?CreateNumber(this YSection section, string name, ulong value)
{
section.EnsureNotNull(nameof(section));
var result = section.CreateNumber(name);
if (result is not null)
{
result.ValueU64 = value;
}
return(result);
}
/// <summary>
/// 指定されたセクションに新しい文字列値を作成し追加します。
/// </summary>
/// <param name="section">新しい文字列値の保存先のセクションです。</param>
/// <param name="name">新しい文字列値の名前です。</param>
/// <param name="value">文字列値です。</param>
/// <returns>
/// 新しい文字列値を表すオブジェクトです。
/// <paramref name="name"/>が既に存在するノードと一致した場合、
/// またはサポートされない場合は<see langword="null"/>を返します。
/// </returns>
/// <exception cref="System.ArgumentNullException"/>
/// <exception cref="CAP.Yencon.Exceptions.InvalidNodeNameException"/>
public static YString?CreateString(this YSection section, string name, string value)
{
section.EnsureNotNull(nameof(section));
var result = section.CreateString(name);
if (result is not null)
{
result.Value = value;
}
return(result);
}
/// <summary>
/// 指定されたセクションに新しい論理値を作成し追加します。
/// </summary>
/// <param name="section">新しい論理値の保存先のセクションです。</param>
/// <param name="name">新しい論理値の名前です。</param>
/// <param name="value">論理値です。</param>
/// <returns>
/// 新しい論理値を表すオブジェクトです。
/// <paramref name="name"/>が既に存在するノードと一致した場合、
/// またはサポートされない場合は<see langword="null"/>を返します。
/// </returns>
/// <exception cref="System.ArgumentNullException"/>
/// <exception cref="CAP.Yencon.Exceptions.InvalidNodeNameException"/>
public static YBoolean?CreateBoolean(this YSection section, string name, bool value)
{
section.EnsureNotNull(nameof(section));
var result = section.CreateBoolean(name);
if (result is not null)
{
result.Value = value;
}
return(result);
}
/// <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>
/// 指定されたセクションへ指定された名前の論理値を設定します。
/// </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>
/// 指定されたセクションへ指定された名前の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>
/// <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));
}
/// <summary>
/// 指定されたセクションから指定された名前のリンク文字列を取得します。
/// </summary>
/// <param name="section">取得元のセクションです。</param>
/// <param name="name">取得するリンク文字列の名前です。</param>
/// <returns>取得に成功した場合はリンク文字列を表すオブジェクト、失敗した場合は<see langword="null"/>を返します。</returns>
/// <exception cref="System.ArgumentNullException"/>
public static YLink?GetLink(this YSection section, string name)
{
section.EnsureNotNull(nameof(section));
section.TryGetNode <YLink>(name, out var result);
return(result);
}
/// <summary>
/// 指定されたセクションから指定された名前の論理値を取得します。
/// </summary>
/// <param name="section">取得元のセクションです。</param>
/// <param name="name">取得する論理値の名前です。</param>
/// <returns>取得に成功した場合は論理値を表すオブジェクト、失敗した場合は<see langword="null"/>を返します。</returns>
/// <exception cref="System.ArgumentNullException"/>
public static YBoolean?GetBoolean(this YSection section, string name)
{
section.EnsureNotNull(nameof(section));
section.TryGetNode <YBoolean>(name, out var result);
return(result);
}
/// <summary>
/// 指定されたセクションから指定された名前の配列を取得します。
/// </summary>
/// <param name="section">取得元のセクションです。</param>
/// <param name="name">取得する配列の名前です。</param>
/// <returns>取得に成功した場合は配列を表すオブジェクト、失敗した場合は<see langword="null"/>を返します。</returns>
/// <exception cref="System.ArgumentNullException"/>
public static YArray?GetArray(this YSection section, string name)
{
section.EnsureNotNull(nameof(section));
section.TryGetNode <YArray>(name, out var result);
return(result);
}