Add clear to list classes

This is needed as a replacement for users of the holder interfaces to
remove all elements from one of the given list classes.

Bug: T128363

Author: Benestar

RELEASE-NOTES.md

@@ -11,6 +11,7 @@
 * Removed `HashArray::indicesAreUpToDate`
 * Removed `HashArray::removeDuplicates`
 * Removed `$acceptDuplicates` feature from `HashArray`
+* Added `clear` to `TermList`, `AliasGroupList` and `StatementList`
 
 ## Version 6.3.1 (2016-11-30)
 

src/Statement/StatementList.php

@@ -341,6 +341,15 @@ public function filter( StatementFilter $filter ) {
 		return $statementList;
 	}
 
+	/**
+	 * Removes all statements from this list.
+	 *
+	 * @since 6.0
+	 */
+	public function clear() {
+		$this->statements = [];
+	}
+
 	/**
 	 * @see http://php.net/manual/en/language.oop5.cloning.php
 	 *

src/Term/AliasGroupList.php

@@ -204,4 +204,13 @@ public function toTextArray() {
 		return $array;
 	}
 
+	/**
+	 * Removes all alias groups from this list.
+	 *
+	 * @since 6.0
+	 */
+	public function clear() {
+		$this->groups = [];
+	}
+
 }

src/Term/TermList.php

@@ -187,4 +187,13 @@ public function hasTerm( Term $term ) {
 			&& $this->terms[$term->getLanguageCode()]->equals( $term );
 	}
 
+	/**
+	 * Removes all terms from this list.
+	 *
+	 * @since 6.0
+	 */
+	public function clear() {
+		$this->terms = [];
+	}
+
 }

tests/unit/Statement/StatementListTest.php

@@ -702,4 +702,14 @@ public function testFilter() {
 		);
 	}
 
+	public function testClear() {
+		$statement1 = $this->getStatement( 1, null );
+		$statement2 = $this->getStatement( 2, null );
+		$statements = new StatementList( $statement1, $statement2 );
+
+		$statements->clear();
+
+		$this->assertEquals( new StatementList(), $statements );
+	}
+
 }

tests/unit/Term/AliasGroupListTest.php

@@ -383,4 +383,14 @@ public function testToTextArray() {
 		$this->assertEquals( $expected, $list->toTextArray() );
 	}
 
+	public function testClear() {
+		$list = new AliasGroupList();
+		$list->setAliasesForLanguage( 'en', [ 'foo', 'baz' ] );
+		$list->setAliasesForLanguage( 'de', [ 'bar' ] );
+
+		$list->clear();
+
+		$this->assertEquals( new AliasGroupList(), $list );
+	}
+
 }

tests/unit/Term/TermListTest.php

@@ -396,4 +396,14 @@ public function testGivenEmptyTerm_setTermRemovesExistingOne() {
 		);
 	}
 
+	public function testClear() {
+		$list = new TermList();
+		$list->setTextForLanguage( 'en', 'foo' );
+		$list->setTextForLanguage( 'de', 'bar' );
+
+		$list->clear();
+
+		$this->assertEquals( new TermList(), $list );
+	}
+
 }