From d9c11bd34a0487668f469067af06d4ee415e6416 Mon Sep 17 00:00:00 2001
From: David Hall <dahall68@gmail.com>
Date: Tue, 21 Jan 2025 08:32:51 -0700
Subject: [PATCH] Added SafeAllocatedMemoryHandleBase.CopyTo methods to copy
 memory segments to pointers and other SafeAllocatedMemoryHandleBase instances

---
 Core/InteropServices/SafeMemoryHandle.cs | 37 ++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/Core/InteropServices/SafeMemoryHandle.cs b/Core/InteropServices/SafeMemoryHandle.cs
index 47c185751..68f6efc47 100644
--- a/Core/InteropServices/SafeMemoryHandle.cs
+++ b/Core/InteropServices/SafeMemoryHandle.cs
@@ -371,6 +371,43 @@ public virtual int CompareTo(IReadOnlyList<byte>? other)
 		return ret;
 	}
 
+	/// <summary>Copies memory from this allocation to an allocated memory pointer.</summary>
+	/// <param name="dest">A pointer to allocated memory that must be at least <paramref name="length"/> bytes.</param>
+	/// <param name="length">The number of bytes to copy.</param>
+	public void CopyTo(IntPtr dest, SizeT length) => CallLocked(p => p.CopyTo(dest, length));
+
+	/// <summary>Copies memory from this allocation to an allocated memory handle.</summary>
+	/// <param name="dest">A safe handle to allocated memory.</param>
+	/// <param name="destOffset">The offset within <paramref name="dest"/> at which to start copying.</param>
+	/// <exception cref="System.ArgumentNullException">dest</exception>
+	/// <exception cref="System.ArgumentOutOfRangeException">destOffset</exception>
+	public void CopyTo(SafeAllocatedMemoryHandleBase dest, SizeT destOffset = default)
+	{
+		if (dest is null) throw new ArgumentNullException(nameof(dest));
+		if (dest.Size < destOffset + Size) throw new ArgumentOutOfRangeException(nameof(destOffset), "The destination buffer is not large enough.");
+		CallLocked(p => p.CopyTo(dest.handle, Size));
+	}
+
+	/// <summary>Copies memory from this allocation to an allocated memory pointer.</summary>
+	/// <param name="start">The starting offset within this allocation at which to start copying.</param>
+	/// <param name="dest">A pointer to allocated memory that must be at least <paramref name="length" /> bytes.</param>
+	/// <param name="length">The number of bytes to copy.</param>
+	public void CopyTo(SizeT start, IntPtr dest, SizeT length) => CallLocked(p => p.CopyTo(start, dest, length));
+
+	/// <summary>Copies memory from this allocation to an allocated memory handle.</summary>
+	/// <param name="start">The starting offset within this allocation at which to start copying.</param>
+	/// <param name="length">The number of bytes to copy.</param>
+	/// <param name="dest">A safe handle to allocated memory.</param>
+	/// <param name="destOffset">The offset within <paramref name="dest"/> at which to start copying.</param>
+	/// <exception cref="System.ArgumentNullException">dest</exception>
+	/// <exception cref="System.ArgumentOutOfRangeException">destOffset - The destination buffer is not large enough.</exception>
+	public void CopyTo(SizeT start, SizeT length, SafeAllocatedMemoryHandleBase dest, SizeT destOffset = default)
+	{
+		if (dest is null) throw new ArgumentNullException(nameof(dest));
+		if (dest.Size < destOffset + length - start) throw new ArgumentOutOfRangeException(nameof(destOffset), "The destination buffer is not large enough.");
+		CallLocked(p => p.CopyTo(start, dest.handle.Offset(destOffset), length));
+	}
+
 	/// <inheritdoc/>
 	public bool Equals(SafeAllocatedMemoryHandleBase? other) => CompareTo(other) == 0;