fix: document empty set behavior. (#84)

serverpod · Mar 27, 2024 · 14d6b2c · 14d6b2c
1 parent 5d9ba65
commit 14d6b2c
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 4 deletions.
diff --git a/docs/05-concepts/06-database/06-filter.md b/docs/05-concepts/06-database/06-filter.md
@@ -98,7 +98,7 @@ await User.db.find(
 );
 ```
 
-In the example we fetch all users with a name matching either Alice or Bob.
+In the example we fetch all users with a name matching either Alice or Bob. If an empty set is used as an argument for the inSet comparison, no rows will be included in the result.
 
 The 'not in set' operation functions similarly to `inSet`, but it negates the condition.
 
@@ -107,7 +107,8 @@ await User.db.find(
   where: (t) => t.name.notInSet({'Alice', 'Bob'})
 );
 ```
-In the example we fetch all users with a name not matching Alice or Bob. Rows with a `null` value in the column will be included in the result.
+In the example we fetch all users with a name not matching Alice or Bob. Rows with a `null` value in the column will be included in the result. If an empty set is used as an argument for the notInSet comparison, all rows will be included in the result.
+
 
 ### Like
 

diff --git a/versioned_docs/version-1.2.0/05-concepts/06-database/06-filter.md b/versioned_docs/version-1.2.0/05-concepts/06-database/06-filter.md
@@ -98,7 +98,7 @@ await User.db.find(
 );
 ```
 
-In the example we fetch all users with a name matching either Alice or Bob.
+In the example we fetch all users with a name matching either Alice or Bob. If an empty set is used as an argument for the inSet comparison, no rows will be included in the result.
 
 The 'not in set' operation functions similarly to `inSet`, but it negates the condition.
 
@@ -107,7 +107,7 @@ await User.db.find(
   where: (t) => t.name.notInSet({'Alice', 'Bob'})
 );
 ```
-In the example we fetch all users with a name not matching Alice or Bob. Rows with a `null` value in the column will be included in the result.
+In the example we fetch all users with a name not matching Alice or Bob. Rows with a `null` value in the column will be included in the result. If an empty set is used as an argument for the notInSet comparison, all rows will be included in the result.
 
 ### Like