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

@@ -15,6 +15,7 @@
     * `getByLangauge` now throws an `OutOfBoundsException`.
     * `removeByLanguage` does nothing for invalid values.
     * `hasTermForLanguage` and `hasGroupForLangauge` return false instead.
+* Added `clear` to `TermList`, `AliasGroupList` and `StatementList`
 
 ## Version 5.1.0 (2016-03-08)
 

src/Statement/StatementList.php

@@ -325,6 +325,15 @@ public function filter( StatementFilter $filter ) {
 		return $statementList;
 	}
 
+	/**
+	 * Removes all statements from this list.
+	 *
+	 * @since 6.0
+	 */
+	public function clear() {
+		$this->statements = array();
+	}
+
 	/**
 	 * @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 = array();
+	}
+
 }

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 = array();
+	}
+
 }

tests/unit/Statement/StatementListTest.php

@@ -650,4 +650,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', array( 'foo', 'baz' ) );
+		$list->setAliasesForLanguage( 'de', array( 'bar' ) );
+
+		$list->clear();
+
+		$this->assertEquals( new AliasGroupList(), $list );
+	}
+
 }

tests/unit/Term/TermListTest.php

@@ -397,4 +397,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 );
+	}
+
 }