docs(database): clarify exists test mode return

memleakd · memleakd · commit 8f00d830b379 · 2026-05-18T13:45:08.000+02:00
Signed-off-by: memleakd &lt;121398829+memleakd@users.noreply.github.com&gt;
diff --git a/system/Database/BaseBuilder.php b/system/Database/BaseBuilder.php
@@ -1987,7 +1987,7 @@ public function countAll(bool $reset = true)
     /**
      * Determines whether the current Query Builder conditions match any rows.
      *
-     * @return bool|string
+     * @return bool|string SQL string when test mode is enabled.
      */
     public function exists(bool $reset = true)
     {
@@ -1999,7 +1999,7 @@ public function exists(bool $reset = true)
     /**
      * Determines whether the current Query Builder conditions do not match any rows.
      *
-     * @return bool|string
+     * @return bool|string SQL string when test mode is enabled.
      */
     public function doesntExist(bool $reset = true)
     {
@@ -2011,7 +2011,7 @@ public function doesntExist(bool $reset = true)
     /**
      * Runs an existence probe for the current Query Builder query.
      *
-     * @return bool|string|null
+     * @return bool|string|null SQL string when test mode is enabled, or null when the query fails.
      */
     protected function doExists(bool $reset = true)
     {

Original file line number	Diff line number	Diff line change
`@@ -1987,7 +1987,7 @@ public function countAll(bool $reset = true)`
`1987`	`1987`	`/**`
`1988`	`1988`	`* Determines whether the current Query Builder conditions match any rows.`
`1989`	`1989`	`*`
`1990`		`- * @return bool\|string`
	`1990`	`+ * @return bool\|string SQL string when test mode is enabled.`
`1991`	`1991`	`*/`
`1992`	`1992`	`public function exists(bool $reset = true)`
`1993`	`1993`	`{`
`@@ -1999,7 +1999,7 @@ public function exists(bool $reset = true)`
`1999`	`1999`	`/**`
`2000`	`2000`	`* Determines whether the current Query Builder conditions do not match any rows.`
`2001`	`2001`	`*`
`2002`		`- * @return bool\|string`
	`2002`	`+ * @return bool\|string SQL string when test mode is enabled.`
`2003`	`2003`	`*/`
`2004`	`2004`	`public function doesntExist(bool $reset = true)`
`2005`	`2005`	`{`
`@@ -2011,7 +2011,7 @@ public function doesntExist(bool $reset = true)`
`2011`	`2011`	`/**`
`2012`	`2012`	`* Runs an existence probe for the current Query Builder query.`
`2013`	`2013`	`*`
`2014`		`- * @return bool\|string\|null`
	`2014`	`+ * @return bool\|string\|null SQL string when test mode is enabled, or null when the query fails.`
`2015`	`2015`	`*/`
`2016`	`2016`	`protected function doExists(bool $reset = true)`
`2017`	`2017`	`{`