add WhereNotIn clause #7

README.md

@@ -112,13 +112,13 @@ $qb->select()->from("wp_users")->whereIn("ID", [1, 2, 3])->get();
 //SELECT * FROM wp_users WHERE ID IN (1, 2, 3);
 ```
 
-### Where column value IN
+### Where column value NOT IN
 
-Adds a `WHERE` clause, matching records which have a column value in the array provided:
+Adds a `WHERE` clause by matching records that do not have a column value in the provided array:
 
 ```php
-$qb->select()->from("wp_users")->whereIn("ID", [1, 2, 3])->get();
-//SELECT * FROM wp_users WHERE ID IN (1, 2, 3);
+$qb->select()->from("wp_users")->whereNotIn("ID", [1, 2, 3])->get();
+//SELECT * FROM wp_users WHERE ID NOT IN (1, 2, 3);
 ```
 
 

src/Query.php

@@ -252,6 +252,11 @@ public function whereIn($column, $values) {
 		return $this;
 	}
 
+	public function whereNotIn($column, $values) {
+		$this->wheres->andWhere(new WhereNotInClause($column,$values));
+		return $this;
+	}
+
 	public function search($fieldOrFields, $searchTerm){
 		$search = new CompositeWhereClause();
 		$fields = is_array($fieldOrFields) ? $fieldOrFields : [$fieldOrFields];

src/WhereNotInClause.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace WPQueryBuilder;
+
+class WhereNotInClause implements WhereClause {
+
+	private $bindings;
+	private $column;
+
+	public function __construct($column, $values){
+		$this->column = $column;
+		$this->bindings = $values;
+	}
+
+	public function buildSql() {
+		$inList = '(' . implode(', ', array_fill(0, count($this->bindings), '%s')) . ')';
+		return implode(' ', [$this->column, "NOT IN", $inList]);
+	}
+
+	public function getBindings(){
+		return $this->bindings;
+	}
+
+}

tests/UnitTests/WhereTest.php

@@ -224,6 +224,19 @@ public function testWithWhereInCondition(){
 			->get();
 	}
 
+	public function testWithWhereNotInCondition(){
+		$this->wpdb->expects($this->once())->method('prepare')->with(
+			"SELECT * FROM tablename WHERE field NOT IN (%s, %s, %s);",
+			['foo', 'bar', 'baz']
+		);
+
+		$qb = new Query($this->wpdb);
+		$qb->select()
+		   ->from("tablename")
+		   ->whereNotIn("field", ['foo', 'bar', 'baz'])
+		   ->get();
+	}
+
 	public function testSearchSingleColumn(){
 		$this->wpdb->expects($this->once())->method('prepare')->with(
 			"SELECT * FROM tablename WHERE (field LIKE %s) AND field2 = %s;",