add Node.Parse/TryParse

Author: smdn

src/Smdn.Fundamental.Uuid/Smdn.Formats.UniversallyUniqueIdentifiers/Node.cs

@@ -1,6 +1,7 @@
 // SPDX-FileCopyrightText: 2009 smdn <smdn@smdn.jp>
 // SPDX-License-Identifier: MIT
 using System;
+using System.Globalization;
 #if SYSTEM_NET_NETWORKINFORMATION_PHYSICALADDRESS
 using System.Net.NetworkInformation;
 #endif
@@ -112,6 +113,45 @@ public bool TryWriteBytes(Span<byte> destination)
     return true;
   }
 
+  public static Node Parse(string s)
+    => TryParse(s ?? throw new ArgumentNullException(nameof(s)), out var result)
+      ? result
+      : throw new FormatException("invalid format");
+
+  public static bool TryParse(string s, out Node result)
+  {
+    result = default;
+
+    if (s is null)
+      return false;
+
+    var p =
+#if SYSTEM_STRING_SPLIT_CHAR
+      s.Split(':', StringSplitOptions.None);
+#else
+      s.Split(new[] { ':' }, StringSplitOptions.None);
+#endif
+
+    if (p.Length != SizeOfSelf)
+      return false;
+    if (!byte.TryParse(p[0], NumberStyles.HexNumber, provider: null, out var n0))
+      return false;
+    if (!byte.TryParse(p[1], NumberStyles.HexNumber, provider: null, out var n1))
+      return false;
+    if (!byte.TryParse(p[2], NumberStyles.HexNumber, provider: null, out var n2))
+      return false;
+    if (!byte.TryParse(p[3], NumberStyles.HexNumber, provider: null, out var n3))
+      return false;
+    if (!byte.TryParse(p[4], NumberStyles.HexNumber, provider: null, out var n4))
+      return false;
+    if (!byte.TryParse(p[5], NumberStyles.HexNumber, provider: null, out var n5))
+      return false;
+
+    result = new(n0, n1, n2, n3, n4, n5);
+
+    return true;
+  }
+
   public override string ToString() => ToString(format: null, formatProvider: null);
 
   public string ToString(string format, IFormatProvider formatProvider = null)

tests/Smdn.Fundamental.Uuid/Smdn.Formats.UniversallyUniqueIdentifiers/Node.cs

@@ -83,6 +83,61 @@ public void TryWriteBytes_DestinationLengthTooShort()
       Assert.IsFalse(node.TryWriteBytes(stackalloc byte[0]), "length 0");
     }
 
+    [Test]
+    public void TestParse_ArgumentNull() => Assert.Throws<ArgumentNullException>(() => Node.Parse(null));
+
+    [TestCase("00:00:00:00:00:00", true, "00:00:00:00:00:00")]
+    [TestCase("01:23:45:67:89:AB", true, "01:23:45:67:89:AB")]
+    [TestCase("FF:FF:FF:FF:FF:FF", true, "FF:FF:FF:FF:FF:FF")]
+    [TestCase("ab:cd:ef:AB:CD:EF", true, "ab:cd:ef:AB:CD:EF")]
+    [TestCase("0:1:2:3:4:F", true, "00:01:02:03:04:0F")]
+    [TestCase("000:001:002:003:004:00F", true, "00:01:02:03:04:0F")]
+    [TestCase("00:00:00:00:00", false, null)]
+    [TestCase("00", false, null)]
+    [TestCase("", false, null)]
+    [TestCase("100:00:00:00:00:00", false, null)]
+    [TestCase("00:00:00:00:00:100", false, null)]
+    [TestCase("00:00:00:00:00:0X", false, null)]
+    [TestCase("00-00-00-00-00-00", false, null)]
+    public void TestParse(string s, bool expectValid, string expectedString)
+    {
+      Node n = default;
+
+      if (expectValid)
+        Assert.DoesNotThrow(() => n = Node.Parse(s));
+      else
+        Assert.Throws<FormatException>(() => n = Node.Parse(s));
+
+      if (expectValid) {
+        Assert.AreEqual(expectedString.ToUpperInvariant(), n.ToString("X"));
+        Assert.AreEqual(expectedString.ToLowerInvariant(), n.ToString("x"));
+      }
+    }
+
+    [TestCase("00:00:00:00:00:00", true, "00:00:00:00:00:00")]
+    [TestCase("01:23:45:67:89:AB", true, "01:23:45:67:89:AB")]
+    [TestCase("FF:FF:FF:FF:FF:FF", true, "FF:FF:FF:FF:FF:FF")]
+    [TestCase("ab:cd:ef:AB:CD:EF", true, "ab:cd:ef:AB:CD:EF")]
+    [TestCase("0:1:2:3:4:F", true, "00:01:02:03:04:0F")]
+    [TestCase("000:001:002:003:004:00F", true, "00:01:02:03:04:0F")]
+    [TestCase("00:00:00:00:00", false, null)]
+    [TestCase("00", false, null)]
+    [TestCase("", false, null)]
+    [TestCase(null, false, null)]
+    [TestCase("100:00:00:00:00:00", false, null)]
+    [TestCase("00:00:00:00:00:100", false, null)]
+    [TestCase("00:00:00:00:00:0X", false, null)]
+    [TestCase("00-00-00-00-00-00", false, null)]
+    public void TestTryParse(string s, bool expectValid, string expectedString)
+    {
+      Assert.AreEqual(expectValid, Node.TryParse(s, out var node));
+
+      if (expectValid) {
+        Assert.AreEqual(expectedString.ToUpperInvariant(), node.ToString("X"));
+        Assert.AreEqual(expectedString.ToLowerInvariant(), node.ToString("x"));
+      }
+    }
+
     [Test]
     public void TestToString()
     {