API defined

As extension-method per #61 (comment)
gfoidl · Nov 9, 2019 · fce80dd · fce80dd
1 parent b6b35f0
commit fce80dd
Show file tree

Hide file tree

Showing 3 changed files with 61 additions and 2 deletions.
diff --git a/source/gfoidl.Base64/Extensions/ReadOnlySequenceExtensions.cs b/source/gfoidl.Base64/Extensions/ReadOnlySequenceExtensions.cs
@@ -0,0 +1,44 @@
+using System;
+using System.Buffers;
+
+namespace gfoidl.Base64
+{
+    public static class ReadOnlySequenceExtensions
+    {
+        public static void Encode(this Base64? encoder, in ReadOnlySequence<byte> data, IBufferWriter<byte>? writer, out long consumed, out long written)
+        {
+            if (data.IsEmpty)
+            {
+                consumed = 0;
+                written  = 0;
+                return;
+            }
+
+            if (encoder is null)
+                ThrowHelper.ThrowArgumentNullException(ExceptionArgument.encoder);
+
+            if (writer is null)
+                ThrowHelper.ThrowArgumentNullException(ExceptionArgument.writer);
+
+            throw new NotImplementedException();
+        }
+        //---------------------------------------------------------------------
+        public static bool TryDecode(this Base64? encoder, in ReadOnlySequence<byte> base64, IBufferWriter<byte>? writer, out long consumed, out long written)
+        {
+            if (base64.IsEmpty)
+            {
+                consumed = 0;
+                written  = 0;
+                return true;
+            }
+
+            if (encoder == null)
+                ThrowHelper.ThrowArgumentNullException(ExceptionArgument.encoder);
+
+            if (writer is null)
+                ThrowHelper.ThrowArgumentNullException(ExceptionArgument.writer);
+
+            throw new NotImplementedException();
+        }
+    }
+}
diff --git a/source/gfoidl.Base64/ThrowHelper.cs b/source/gfoidl.Base64/ThrowHelper.cs
@@ -18,6 +18,7 @@ static ThrowHelper()
             s_resources = new Lazy<ResourceManager>(() => new ResourceManager($"{ns}.Strings", typeof(ThrowHelper).Assembly));
         }
         //---------------------------------------------------------------------
+        public static void ThrowArgumentNullException(ExceptionArgument argument)       => throw GetArgumentNullException(argument);
         public static void ThrowArgumentOutOfRangeException(ExceptionArgument argument) => throw GetArgumentOutOfRangeException(argument);
         public static void ThrowMalformedInputException(int urlEncodedLen)              => throw GetMalformdedInputException(urlEncodedLen);
         public static void ThrowForOperationNotDone(OperationStatus status)             => throw GetExceptionForOperationNotDone(status);
@@ -27,6 +28,11 @@ public static void ThrowArgumentOutOfRangeException(ExceptionArgument argument,
             throw GetArgumentOutOfRangeException(argument, ressource);
         }
         //---------------------------------------------------------------------
+        private static Exception GetArgumentNullException(ExceptionArgument argument)
+        {
+            return new ArgumentNullException(GetArgumentName(argument));
+        }
+        //---------------------------------------------------------------------
         private static Exception GetArgumentOutOfRangeException(ExceptionArgument argument)
         {
             return new ArgumentOutOfRangeException(GetArgumentName(argument));
@@ -75,8 +81,10 @@ private static string GetResource(ExceptionRessource ressource)
     //-------------------------------------------------------------------------
     internal enum ExceptionArgument
     {
+        encoder,
+        encodedLength,
         length,
-        encodedLength
+        writer
     }
     //---------------------------------------------------------------------
     internal enum ExceptionRessource

diff --git a/source/gfoidl.Base64/gfoidl.Base64.csproj b/source/gfoidl.Base64/gfoidl.Base64.csproj
@@ -49,6 +49,7 @@ For .NET Core 3.0 onwards encoding / decoding is done with SIMD-support.
         <Compile Remove="**\*.netstandard.cs" />
         <Compile Remove="**\*.sse.cs" />
         <Compile Remove="**\*.avx.cs" />
+        <Compile Remove="Extensions\ReadOnlySequenceExtensions.cs" />
     </ItemGroup>
 
     <ItemGroup>
@@ -64,9 +65,15 @@ For .NET Core 3.0 onwards encoding / decoding is done with SIMD-support.
         <Compile Include="**\*.netcoreapp.cs" />
         <Compile Include="**\*.sse.cs" />
         <Compile Include="**\*.avx.cs" />
+        <Compile Include="Extensions\ReadOnlySequenceExtensions.cs" />
     </ItemGroup>
 
-    <ItemGroup Condition="'$(TargetFramework)' == 'netstandard2.0' or '$(TargetFramework)' == 'netstandard2.1'">
+    <ItemGroup Condition="'$(TargetFramework)' == 'netstandard2.1'">
+        <Compile Include="**\*.netstandard.cs" />
+        <Compile Include="Extensions\ReadOnlySequenceExtensions.cs" />
+    </ItemGroup>
+
+    <ItemGroup Condition="'$(TargetFramework)' == 'netstandard2.0'">
         <Compile Include="**\*.netstandard.cs" />
     </ItemGroup>