Test taxonomy_term_load_multiple_by_name().
function testTaxonomyGetTermByName() {
$term = $this
->createTerm($this->vocabulary);
// Load the term with the exact name.
$terms = taxonomy_term_load_multiple_by_name($term
->label());
$this
->assertTrue(isset($terms[$term
->id()]), 'Term loaded using exact name.');
// Load the term with space concatenated.
$terms = taxonomy_term_load_multiple_by_name(' ' . $term
->label() . ' ');
$this
->assertTrue(isset($terms[$term
->id()]), 'Term loaded with extra whitespace.');
// Load the term with name uppercased.
$terms = taxonomy_term_load_multiple_by_name(strtoupper($term
->label()));
$this
->assertTrue(isset($terms[$term
->id()]), 'Term loaded with uppercased name.');
// Load the term with name lowercased.
$terms = taxonomy_term_load_multiple_by_name(strtolower($term
->label()));
$this
->assertTrue(isset($terms[$term
->id()]), 'Term loaded with lowercased name.');
// Try to load an invalid term name.
$terms = taxonomy_term_load_multiple_by_name('Banana');
$this
->assertFalse($terms);
// Try to load the term using a substring of the name.
$terms = taxonomy_term_load_multiple_by_name(drupal_substr($term
->label(), 2));
$this
->assertFalse($terms);
// Create a new term in a different vocabulary with the same name.
$new_vocabulary = $this
->createVocabulary();
$new_term = entity_create('taxonomy_term', array(
'name' => $term
->label(),
'vid' => $new_vocabulary
->id(),
));
$new_term
->save();
// Load multiple terms with the same name.
$terms = taxonomy_term_load_multiple_by_name($term
->label());
$this
->assertEqual(count($terms), 2, 'Two terms loaded with the same name.');
// Load single term when restricted to one vocabulary.
$terms = taxonomy_term_load_multiple_by_name($term
->label(), $this->vocabulary
->id());
$this
->assertEqual(count($terms), 1, 'One term loaded when restricted by vocabulary.');
$this
->assertTrue(isset($terms[$term
->id()]), 'Term loaded using exact name and vocabulary machine name.');
// Create a new term with another name.
$term2 = $this
->createTerm($this->vocabulary);
// Try to load a term by name that doesn't exist in this vocabulary but
// exists in another vocabulary.
$terms = taxonomy_term_load_multiple_by_name($term2
->label(), $new_vocabulary
->id());
$this
->assertFalse($terms, 'Invalid term name restricted by vocabulary machine name not loaded.');
// Try to load terms filtering by a non-existing vocabulary.
$terms = taxonomy_term_load_multiple_by_name($term2
->label(), 'non_existing_vocabulary');
$this
->assertEqual(count($terms), 0, 'No terms loaded when restricted by a non-existing vocabulary.');
}