release/v4.0.0

Author: andreise

src/core-unit/Unit/Unit.csproj

@@ -19,7 +19,7 @@
     <Description>PrimeFuncPack Core.Unit is a core library for .NET consisting of Unit type targeted for use in functional programming.</Description>
     <RootNamespace>System</RootNamespace>
     <AssemblyName>PrimeFuncPack.Core.Unit</AssemblyName>
-    <Version>4.0.0-rc.1</Version>
+    <Version>4.0.0</Version>
   </PropertyGroup>
 
   <ItemGroup>

src/core-unit/Unit/UnitFormatting/UnitFormUtf8.cs

@@ -17,6 +17,8 @@ internal static class UnitFormUtf8
     internal static ReadOnlySpan<byte> JsonObjExtended => new(InnerBytes.JsonObjExtended);
     internal static ReadOnlySpan<byte> EmptyExtended => new(InnerBytes.EmptyExtended);
 
+    // We initialize the byte arrays inline with no static ctor to obtain and cache them
+    // lazily only on demand, and also isolate them in a nested class for thread-safety.
     private static class InnerBytes
     {
         internal static readonly byte[] General = InnerGetBytes(UnitForm.General);
@@ -29,6 +31,7 @@ private static class InnerBytes
         internal static readonly byte[] JsonObjExtended = InnerGetBytes(UnitForm.JsonObjExtended);
         internal static readonly byte[] EmptyExtended = InnerGetBytes(UnitForm.EmptyExtended);
 
+        // We use the most proven method to obtain UTF-8 bytes.
         private static byte[] InnerGetBytes(string s)
             =>
             Encoding.UTF8.GetBytes(s);