From 8844c3c4381fa9a28f890461b469631886e71481 Mon Sep 17 00:00:00 2001
From: "Adam D. Ruppe" <destructionator@gmail.com>
Date: Tue, 12 Sep 2023 21:28:36 -0400
Subject: [PATCH] document another part of the breaking change

---
 database.d | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/database.d b/database.d
index c64d484..4a8cb4d 100644
--- a/database.d
+++ b/database.d
@@ -33,6 +33,18 @@
 		how to work it in without breaking a decade of code.
 
 		On June 7, 2023 (dub 11.0), I started the process of moving away from strings as the inner storage unit. This is a potentially breaking change, but you can use `.toString` to convert as needed and `alias this` will try to do this automatically in many situations. See [DatabaseDatum] for details. This transition is not yet complete.
+
+		Notably, passing it to some std.string functions will cause errors referencing DatabaseDatum like:
+
+		$(CONSOLE
+		Error: template `std.array.replace` cannot deduce function from argument types `!()(string, string, DatabaseDatum)`
+		path/phobos/std/array.d(2459):        Candidates are: `replace(E, R1, R2)(E[] subject, R1 from, R2 to)`
+		  with `E = immutable(char),
+		       R1 = string,
+		       R2 = DatabaseDatum`
+		)
+
+		Because templates do not trigger alias this - you will need to call `.toString()` yourself at the usage site.
 +/
 module arsd.database;
 
@@ -177,6 +189,8 @@ struct DatabaseDatum {
 	}
 	/++
 		For compatibility with earlier versions of the api, all data can easily convert to string implicitly and opCast keeps to!x(this) working.
+
+		The toArsdJsVar one is in particular subject to change.
 	+/
 	alias toString this;
 
@@ -185,6 +199,9 @@ struct DatabaseDatum {
 		import std.conv;
 		return to!T(this.toString);
 	}
+
+	/// ditto
+	string toArsdJsVar() { return this.toString; }
 }
 
 /++