/// <summary>
/// <see cref="DataTable"/> 型の拡張メソッドを提供する静的クラスです。
/// </summary>
public static class DataTableExtensions
{
    /// <summary>
    /// 指定した <see cref="DataTable"/> が null であるか、行が存在しないかを示す値を返します。
    /// </summary>
    /// <param name="table">対象の DataTable 型。</param>
    /// <returns>指定した <see cref="DataTable"/> が null であるか、行が存在しない場合は true、それ以外の場合は false を返します。</returns>
    public static bool IsNullOrEmpty(this DataTable? table)
    {
        return table == null || table.Rows.Count == 0;
    }

    /// <summary>
    /// DataTable の指定したセルの値を文字列として取得します。取得に失敗した場合は、指定した既定値を返します。
    /// </summary>
    /// <param name="table">対象の DataTable 型。</param>
    /// <param name="rowIndex">取得する行のインデックス。</param>
    /// <param name="columnIndex">取得する列のインデックス。</param>
    /// <param name="defaultValue">取得失敗した場合に返す既定値。</param>
    /// <returns>取得に成功した場合は文字列、失敗した場合は規定値を返します。</returns>
    public static string GetStringOrDefault(
        this DataTable? table,
        int rowIndex,
        int columnIndex,
        string defaultValue = "")
    {
        if (table.IsNullOrEmpty())
        {
            return defaultValue;
        }

        if (rowIndex < 0 || rowIndex >= table!.Rows.Count)
        {
            return defaultValue;
        }

        if (columnIndex < 0 || columnIndex >= table.Columns.Count)
        {
            return defaultValue;
        }

        return table
            .Rows[rowIndex][columnIndex]
            .ToStringOrDefault(defaultValue);
    }

    /// <summary>
    /// DataTable の指定したセルの値を文字列として取得します。取得に失敗した場合は、指定した既定値を返します。
    /// </summary>
    /// <param name="table">対象の DataTable 型。</param>
    /// <param name="rowIndex">取得する行のインデックス。</param>
    /// <param name="columnName">取得する列の名前。</param>
    /// <param name="defaultValue">取得失敗した場合に返す既定値。</param>
    /// <returns>取得に成功した場合は文字列、失敗した場合は規定値を返します。</returns>
    public static string GetStringOrDefault(
        this DataTable? table,
        int rowIndex,
        string columnName,
        string defaultValue = "")
    {
        if (table.IsNullOrEmpty())
        {
            return defaultValue;
        }

        if (rowIndex < 0 || rowIndex >= table!.Rows.Count)
        {
            return defaultValue;
        }

        if (!table.Columns.Contains(columnName))
        {
            return defaultValue;
        }

        return table
            .Rows[rowIndex][columnName]
            .ToStringOrDefault(defaultValue);
    }

    /// <summary>
    /// 指定した <see cref="DataTable"/> の行を列挙可能なコレクションとして返します。
    /// </summary>
    /// <param name="table">対象の DataTable 型。</param>
    /// <returns>指定した <see cref="DataTable"/> の行を列挙可能なコレクションとして返します。</returns>
    public static IEnumerable<DataRow> AsEnumerableSafe(this DataTable? table)
    {
        #pragma warning disable IDE0301
        return table?.Rows.Cast<DataRow>() ?? Enumerable.Empty<DataRow>();
        #pragma warning restore IDE0301
    }

    /// <summary>
    /// 指定した <see cref="DataTable"/> の行をリストとして返します。
    /// </summary>
    /// <param name="table">対象の DataTable 型。</param>
    /// <returns>指定した <see cref="DataTable"/> の行をリストとして返します。</returns>
    public static List<DataRow> ToDataRowList(this DataTable? table) => [.. table.AsEnumerableSafe()];
}