using Misaki.HighPerformance.LowLevel.Collections;
using Misaki.HighPerformance.LowLevel.Collections.Contracts;
using System.Runtime.InteropServices;
namespace Misaki.HighPerformance.LowLevel.Helpers;
///
/// Provides extension methods for copying elements between unsafe collections and spans, converting collections to
/// arrays or lists, and searching for values.
///
public unsafe static class UnsafeCollectionExtensions
{
///
/// Copies elements from a source UnsafeCollection to a destination Span, ensuring both have the same size.
///
/// Specifies the type of elements being copied, which must be unmanaged.
/// Represents the source collection from which elements are copied.
/// Represents the target span where elements are copied to.
/// Thrown when the sizes of the source collection and destination span do not match.
public static void CopyTo(this IUnsafeCollection source, Span destination)
where T : unmanaged
{
if (source.Count > destination.Length)
{
throw new ArgumentException("Source collection is larger than the destination span.");
}
fixed (T* ptr = destination)
{
SystemUnsfae.CopyBlock(ptr, source.GetUnsafePtr(), (uint)(source.Count * sizeof(T)));
}
}
///
/// Copies a range of elements from a source collection to a destination span, ensuring both are adequately sized.
///
/// Specifies the type of elements being copied, which must be a value type.
/// The collection from which elements are copied.
/// The span where the elements will be copied to.
/// The starting index in the source collection for the copy operation.
/// The starting index in the destination span where the elements will be placed.
/// The number of elements to copy from the source to the destination.
/// Thrown when the specified range exceeds the bounds of the source collection or destination span.
public static void CopyTo(this IUnsafeCollection source, Span destination, int sourceIndex, int destinationIndex, int length)
where T : unmanaged
{
if (sourceIndex + length > source.Count || destinationIndex + length > destination.Length)
{
throw new ArgumentException("Source collection or destination span is too small for the specified range.");
}
fixed (T* ptr = destination)
{
SystemUnsfae.CopyBlock(ptr + destinationIndex, (byte*)source.GetUnsafePtr() + sourceIndex * sizeof(T), (uint)(length * sizeof(T)));
}
}
///
/// Copies elements from a source span to a destination unsafe collection, ensuring both have the same size.
///
/// Specifies the type of elements being copied, which must be unmanaged.
/// Represents the unsafe collection that will receive the copied elements.
/// Represents the span containing the elements to be copied to the unsafe collection.
/// Thrown when the source span and destination collection have different sizes.
public static void CopyFrom(this IUnsafeCollection destination, Span source)
where T : unmanaged
{
if (destination.Count > source.Length)
{
throw new ArgumentException("Destination collection is larger than the source span.");
}
fixed (T* ptr = source)
{
SystemUnsfae.CopyBlock(destination.GetUnsafePtr(), ptr, (uint)(source.Length * sizeof(T)));
}
}
///
/// Copies a specified range of elements from a source span to a destination collection.
///
/// Represents the type of elements being copied, which must be unmanaged.
/// The collection where elements will be copied to.
/// The span containing the elements to be copied.
/// The starting index in the source span from which to begin copying.
/// The starting index in the destination collection where the elements will be placed.
/// The number of elements to copy from the source span to the destination collection.
/// Thrown when the specified range exceeds the bounds of the source span or destination collection.
public static void CopyFrom(this IUnsafeCollection destination, Span source, int sourceIndex, int destinationIndex, int length)
where T : unmanaged
{
if (sourceIndex + length > source.Length || destinationIndex + length > destination.Count)
{
throw new ArgumentException("Source span or destination collection is too small for the specified range.");
}
fixed (T* ptr = source)
{
SystemUnsfae.CopyBlock((byte*)destination.GetUnsafePtr() + destinationIndex * sizeof(T), ptr + sourceIndex, (uint)(length * sizeof(T)));
}
}
///
/// Converts an UnsafeCollection into a Span for efficient memory access.
///
/// Represents a type that can be stored in unmanaged memory.
/// The UnsafeCollection instance to be converted into a Span.
/// A Span that provides a view over the elements of the UnsafeCollection.
public static Span AsSpan(this IUnsafeCollection source)
where T : unmanaged
{
return new(source.GetUnsafePtr(), source.Count);
}
public static UnsafeArray ToUnsafeArray(this T[] source, Allocator allocator)
where T : unmanaged
{
var array = new UnsafeArray(source.Length, allocator);
fixed (T* ptr = source)
{
MemCpy(array.GetUnsafePtr(), ptr, (uint)(source.Length * sizeof(T)));
}
return array;
}
public static UnsafeList ToUnsafeList(this List source, Allocator allocator)
where T : unmanaged
{
var list = new UnsafeList(source.Count, allocator);
fixed (T* ptr = CollectionsMarshal.AsSpan(source))
{
MemCpy(list.GetUnsafePtr(), ptr, (uint)(source.Count * sizeof(T)));
}
return list;
}
}