update docs

Author: cbaker6

ParseSwift.playground/Pages/13 - Operations.xcplaygroundpage/Contents.swift

@@ -72,13 +72,22 @@ do {
     print(error)
 }
 
-//: Query all scores who have a name.
+//: Query all scores whose is null or undefined.
 let query1 = GameScore.query(notNull(key: "name"))
 let results1 = try query1.find()
+print("Total found: \(results1.count)")
 results1.forEach { score in
     print("Found score with a name: \(score)")
 }
 
+//: Query all scores whose name is undefined.
+let query2 = GameScore.query(exists(key: "name"))
+let results2 = try query2.find()
+print("Total found: \(results2.count)")
+results2.forEach { score in
+    print("Found score with a name: \(score)")
+}
+
 //: You can also remove a value for a property using unset.
 let unsetOperation = savedScore
     .operation.unset(("points", \.points))
@@ -100,13 +109,22 @@ do {
     print(error)
 }
 
-//: Query synchronously (not preferred - all operations on main queue).
-let query2 = GameScore.query(isNull(key: "name"))
-let results2 = try query2.find()
-results2.forEach { score in
+//: Query all scores whose name is null or undefined.
+let query3 = GameScore.query(isNull(key: "name"))
+let results3 = try query3.find()
+print("Total found: \(results3.count)")
+results3.forEach { score in
     print("Found score with name is null: \(score)")
 }
 
+//: Query all scores whose name is undefined.
+let query4 = GameScore.query(doesNotExist(key: "name"))
+let results4 = try query4.find()
+print("Total found: \(results4.count)")
+results4.forEach { score in
+    print("Found score with name does not exist: \(score)")
+}
+
 //: There are other operations: set/forceSet/unset/add/remove, etc. objects from `ParseObject`s.
 //: In fact, the `users` and `roles` relations from `ParseRoles` used the add/remove operations.
 //: Multiple operations can be chained together. See:

ParseSwift.playground/Pages/7 - GeoPoint.xcplaygroundpage/Contents.swift

@@ -136,7 +136,7 @@ query2.find { results in
     }
 }
 
-//: If you want to query for points > 50 and don't have a `ParseGeoPoint`.
+//: If you want to query for points > 50 and whose location is undefined.
 var query3 = GameScore.query("points" > 50, doesNotExist(key: "location"))
 query3.find { results in
     switch results {
@@ -154,7 +154,7 @@ query3.find { results in
     }
 }
 
-//: Get the same results as the previous query using `isNull`.
+//: If you want to query for points > 50 and whose location is null or undefined.
 var anotherQuery3 = GameScore.query("points" > 50, isNull(key: "location"))
 anotherQuery3.find { results in
     switch results {
@@ -172,7 +172,7 @@ anotherQuery3.find { results in
     }
 }
 
-//: If you want to query for points > 9 and have a `ParseGeoPoint`.
+//: If you want to query for points > 9 and whose location is not undefined.
 var query4 = GameScore.query("points" > 9, exists(key: "location"))
 query4.find { results in
     switch results {
@@ -191,7 +191,7 @@ query4.find { results in
     }
 }
 
-//: Get the same results as the previous query using `notNull`.
+//: Get the same results as the previous query whose location is not null or undefined.
 var anotherQuery4 = GameScore.query("points" > 9, notNull(key: "location"))
 anotherQuery4.find { results in
     switch results {

Sources/ParseSwift/Types/QueryConstraint.swift

@@ -172,24 +172,6 @@ public func != <T>(key: String, value: T) throws -> QueryConstraint where T: Par
     try QueryConstraint(key: key, value: value.toPointer(), comparator: .notEqualTo)
 }
 
-/**
- Add a constraint that requires that a key is equal to **null**.
- - parameter key: The key that the value is stored in.
- - returns: The same instance of `QueryConstraint` as the receiver.
- */
-public func isNull (key: String) -> QueryConstraint {
-    QueryConstraint(key: key, isNull: true)
-}
-
-/**
- Add a constraint that requires that a key is not equal to **null**.
- - parameter key: The key that the value is stored in.
- - returns: The same instance of `QueryConstraint` as the receiver.
- */
-public func notNull (key: String) -> QueryConstraint {
-    QueryConstraint(key: key, comparator: .notEqualTo, isNull: true)
-}
-
 internal struct InQuery<T>: Encodable where T: ParseObject {
     let query: Query<T>
     var className: String {
@@ -708,7 +690,25 @@ public func hasSuffix(key: String, suffix: String, modifiers: String? = nil) ->
 }
 
 /**
-  Add a constraint that requires a particular key exists.
+ Add a constraint that requires that a key is equal to **null** or **undefined**.
+ - parameter key: The key that the value is stored in.
+ - returns: The same instance of `QueryConstraint` as the receiver.
+ */
+public func isNull (key: String) -> QueryConstraint {
+    QueryConstraint(key: key, isNull: true)
+}
+
+/**
+ Add a constraint that requires that a key is not equal to **null** or **undefined**.
+ - parameter key: The key that the value is stored in.
+ - returns: The same instance of `QueryConstraint` as the receiver.
+ */
+public func notNull (key: String) -> QueryConstraint {
+    QueryConstraint(key: key, comparator: .notEqualTo, isNull: true)
+}
+
+/**
+  Add a constraint that requires a particular key to be equal to **undefined**.
   - parameter key: The key that should exist.
   - returns: The resulting `QueryConstraint`.
  */
@@ -717,7 +717,7 @@ public func exists(key: String) -> QueryConstraint {
 }
 
 /**
-  Add a constraint that requires a key not exist.
+  Add a constraint that requires a key  to not be equal to **undefined**.
   - parameter key: The key that should not exist.
   - returns: The resulting `QueryConstraint`.
  */