From a702b1dcdd77e665cb5e97c9ef808846af498460 Mon Sep 17 00:00:00 2001
From: YoshiRulz <OSSYoshiRulz+GitHub@gmail.com>
Date: Wed, 20 Nov 2024 01:04:47 +1000
Subject: [PATCH] Updated C# and .NET docs supplement (markdown)

---
 C#-and-.NET-docs-supplement.md | 48 +++++++++++++++++++++++++++++++++-
 1 file changed, 47 insertions(+), 1 deletion(-)

diff --git a/C#-and-.NET-docs-supplement.md b/C#-and-.NET-docs-supplement.md
index 9e815f2..4b3abaf 100644
--- a/C#-and-.NET-docs-supplement.md
+++ b/C#-and-.NET-docs-supplement.md
@@ -66,7 +66,53 @@ You can only have 1 `default:` branch (not to be confused with `case default:`),
 
 ## `MemoryMarshal.Cast` can't be used with reference types
 
-See [this SO answer](https://stackoverflow.com/a/79146967/7467292). tl;dr: It's possible in .NET Core only.
+See [this SO answer](https://stackoverflow.com/a/79146967). tl;dr: It's possible in .NET Core only.
+
+<details>
+<summary>full implementations of extension methods for later</summary>
+
+```csharp
+public static Span<TTo> Cast<TFrom, TTo>(Span<TFrom> span)
+	where TTo: class
+	where TFrom: class
+{
+	if (typeof(TTo).IsAssignableFrom(typeof(TFrom))) throw new InvalidCastException();
+	return UnsafeDowncast<TFrom, TTo>(span);
+}
+
+public static ReadOnlySpan<TTo> Cast<TFrom, TTo>(ReadOnlySpan<TFrom> span)
+	where TTo: class
+	where TFrom: class
+{
+	if (typeof(TTo).IsAssignableFrom(typeof(TFrom))) throw new InvalidCastException();
+	return UnsafeDowncast<TFrom, TTo>(span);
+}
+
+public static Span<TBase> CastUp<TDerived, TBase>(Span<TDerived> span)
+	where TBase: class
+	where TDerived: class, TBase
+	=> UnsafeDowncast<TDerived, TBase>(span);
+
+public static ReadOnlySpan<TBase> CastUp<TDerived, TBase>(ReadOnlySpan<TDerived> span)
+	where TBase: class
+	where TDerived: class, TBase
+	=> UnsafeDowncast<TDerived, TBase>(span);
+
+public static Span<TTo> UnsafeDowncast<TFrom, TTo>(Span<TFrom> span)
+	where TTo: class
+	where TFrom: class
+	=> MemoryMarshal.CreateSpan<TTo>(
+		ref Unsafe.As<TFrom, TTo>(ref MemoryMarshal.GetReference(span)),
+		span.Length);
+
+public static ReadOnlySpan<TTo> UnsafeDowncast<TFrom, TTo>(ReadOnlySpan<TFrom> span)
+	where TTo: class
+	where TFrom: class
+	=> MemoryMarshal.CreateReadOnlySpan<TTo>(
+		ref Unsafe.As<TFrom, TTo>(ref MemoryMarshal.GetReference(span)),
+		span.Length);
+```
+</details>
 
 ## MSBuild `Condition` placement