From 77765756efe362e0c187e9001db7117aba67ea96 Mon Sep 17 00:00:00 2001
From: Elias Batek <desisma@heidel.beer>
Date: Wed, 24 Apr 2024 02:07:24 +0200
Subject: [PATCH] Add typeCast examples

---
 core.d | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/core.d b/core.d
index 3078f12..f971c60 100644
--- a/core.d
+++ b/core.d
@@ -186,7 +186,28 @@ version(Posix) {
 
 	$(TIP
 		This is a helper function for readability purposes.
+		The idea is to make type-casting as accessible as `to()` from `std.conv`.
 	)
+
+	---
+	int i =    cast(int)(foo * bar);
+	int i = typeCast!int(foo * bar);
+
+	int j = cast(int) round(floatValue);
+	int j = round(floatValue).typeCast!int;
+
+	int k = cast(int) floatValue + foobar;
+	int k = floatValue.typeCast!int + foobar;
+
+	auto m = Point(
+		cast(int) calc(a.x, b.x),
+		cast(int) calc(a.y, b.y),
+	);
+	auto m = Point(
+		calc(a.x, b.x).typeCast!int,
+		calc(a.y, b.y).typeCast!int,
+	);
+	---
  +/
 auto ref T typeCast(T, S)(auto ref S v) {
 	return cast(T) v;