MmsCore.Utilities 0.1.4

[!IMPORTANT] This Project is not yet stable. Breaking changes may occur at any time.

MmsCore.Utilities

MmsCore.Utilitiesは、文字列表現からNULL可能な型を解析したり、値域を表現したり、値域に対する操作を実行したりするような一般的なタスクのためのユーティリティクラスや拡張機能を提供します。

🚀 Getting Started

JsonCopier

![TIPS] JsonCopier は "深いコピー (Deep Clone)" を実行します。これは新たに生成されたクローンが元のオブジェクトから完全に独立していることを意味します。

JsonCopier<T> を使用して T型のオブジェクトを一つから別のものにコピーする方法の例です。

private sealed class Hoge
{
    public int Property1 { get; set; }
    public string Property2 { get; set; } = default!;
}

var source = new Hoge{ Property1 = 100, Property2 = "ほげ" };
var cloned = JsonCopier.DeepClone(source);

Assert.NotNull(cloned);
Assert.Equal(source.Property1, cloned.Property1);
Assert.Equal(source.Property2, cloned.Property2);

NullableParser

文字列からnull許容型への変換が可能になります。成功時には該当型の値が、解析に失敗した場合には null が返されます。

NullableParser.Parse<T>(string) を使用して、null 許容型へ変換する方法の例です。

var parsed = NullableParser.Parse<bool>("false");
Assert.True(parsed is false);

var parsed = NullableParser.Parse<bool>("true");
Assert.True(parsed);

var parsed = NullableParser.Parse<bool>("0");
Assert.False(parsed.HasValue);

var parsed = NullableParser.Parse<int>("123");
Assert.Equal(123, parsed ?? 0);

var parsed = NullableParser.Parse<double>("-1.643e6");
Assert.Equal(-1643000d, parsed ?? 0);

var parsed = NullableParser.Parse<double>(@"\1,643.57");
Assert.False(parsed.HasValue);

NullableParser.ParseToNumber<T>(string, NumberStyles, IFormatProvider?) を使用して、null 許容型へ変換する方法の例です。

var parsed = NullableParser.ParseToNumber<double>(
    @"\1,643.57",
    NumberStyles.Currency,
    CultureInfo.GetCultureInfo("ja-JP"));
Assert.Equal(1643.57d, parsed ?? 0);

NullableParser.ParseToDateTime(string, string) を使用して、null 許容型へ変換する方法の例です。

var parsed = NullableParser.ParseToDateTime("2014/11/11 12:34:56", "yyyy/MM/dd HH:mm:ss");
Assert.Equal(DateTime.Parse("2014/11/11 12:34:56", CultureInfo.InvariantCulture), parsed ?? DateTime.Today);

ValueRange

// RangeA : inclusiveLowerBound: true, inclusiveUpperBound: true
// RangeB : inclusiveLowerBound: true, inclusiveUpperBound: true
// RangeA :      [5,6,7,8,9]
// RangeB :
//      B0:  [3,4]                 ... OverlapsWith=false/IntersectsWith=false (After)
//      B1:  [3,4,5]               ... OverlapsWith=false/IntersectsWith=true  (Start Touching)
//      B2:  [3,4,5,6]             ... OverlapsWith=true /IntersectsWith=true  (Start Inside)
//      B3:      [5,6,7,8,9,10,11] ... OverlapsWith=true /IntersectsWith=true  (Inside Start Touching)
//      B4:      [5,6,7,8]         ... OverlapsWith=true /IntersectsWith=true  (Enclosing Start Touching)
//      B5:        [6,7,8]         ... OverlapsWith=true /IntersectsWith=true  (Enclosing)
//      B6:        [6,7,8,9]       ... OverlapsWith=true /IntersectsWith=true  (Enclosing End Touching)
//      B7:      [5,6,7,8,9]       ... OverlapsWith=true /IntersectsWith=true  (Exact Match)
//      B8:    [4,5,6,7,8,9,10]    ... OverlapsWith=true /IntersectsWith=true  (Inside)
//      B9:    [4,5,6,7,8,9]       ... OverlapsWith=true /IntersectsWith=true  (Inside End Touching)
//     B10:            [8,9,10,11] ... OverlapsWith=true /IntersectsWith=true  (End Inside)
//     B11:              [9,10,11] ... OverlapsWith=false/IntersectsWith=true  (End Touching)
//     B12:                [10,11] ... OverlapsWith=false/IntersectsWith=false (Before)
var rangeA = Range.Create(5, 9, inclusiveUpperBound: true);
var rangeB1 = Range.Create(3, 5, inclusiveUpperBound: true);
Assert.False(rangeA.OverlapsWith(rangeB1));
Assert.True(rangeA.IntersectsWith(rangeB1));

ValueRangeExtensions.IntersectsWith を使用して、特定の値範囲が他の値範囲と交差しているかどうかを判断する方法の例です。

// 値範囲を定義します
var rangeA = ValueRange.Create(5, 9, inclusiveUpperBound: true);
var rangeB = ValueRange.Create(3, 5, inclusiveUpperBound: true);

// IntersectsWith メソッドを使用して範囲が交差しているかを確認します
var intersects = rangeA.IntersectsWith(rangeB);

// Assert
Assert.True(intersects);

ValueRangeExtensions.OverlapsWith を使用して、特定の値範囲が他の値範囲と重複しているかどうかを判断する方法の例です。

// 値範囲を定義します
var rangeA = ValueRange.Create(5, 9, inclusiveUpperBound: true);
var rangeB = ValueRange.Create(3, 5, inclusiveUpperBound: true);

// OverlapsWith メソッドを使用して範囲が重複しているかを確認します
var overlaps = rangeA.OverlapsWith(rangeB);

// Assert
Assert.False(overlaps);

🙏 Acknowledgments

• Newtonsoft.Json