ElggEntity::deleteRelationships PHP Method

    public function deleteRelationships($relationship = null)
    {
        $relationship = (string) $relationship;
        $result = remove_entity_relationships($this->getGUID(), $relationship);
        return $result && remove_entity_relationships($this->getGUID(), $relationship, true);
    }

 public function testEntityMethodDeleteRelationships()
 {
     $this->assertTrue($this->entity1->addRelationship($this->entity2->guid, 'test_relationship'));
     $r = check_entity_relationship($this->entity1->guid, 'test_relationship', $this->entity2->guid);
     $this->assertIsA($r, 'ElggRelationship');
     $this->assertTrue($this->entity1->addRelationship($this->entity3->guid, 'test_relationship'));
     $r = check_entity_relationship($this->entity1->guid, 'test_relationship', $this->entity3->guid);
     $this->assertIsA($r, 'ElggRelationship');
     $this->assertTrue($this->entity3->addRelationship($this->entity1->guid, 'test_relationship'));
     $r = check_entity_relationship($this->entity3->guid, 'test_relationship', $this->entity1->guid);
     $this->assertIsA($r, 'ElggRelationship');
     $this->assertTrue($this->entity1->deleteRelationships('test_relationship'));
     $this->assertFalse(check_entity_relationship($this->entity1->guid, 'test_relationship', $this->entity2->guid));
     $this->assertFalse(check_entity_relationship($this->entity1->guid, 'test_relationship', $this->entity3->guid));
     // inverse relationships should be gone too
     $this->assertFalse(check_entity_relationship($this->entity3->guid, 'test_relationship', $this->entity1->guid));
     // Repeat above test, but with no relationship - should remove all relationships
     $this->assertTrue($this->entity1->addRelationship($this->entity2->guid, 'test_relationship'));
     $r = check_entity_relationship($this->entity1->guid, 'test_relationship', $this->entity2->guid);
     $this->assertIsA($r, 'ElggRelationship');
     $this->assertTrue($this->entity1->addRelationship($this->entity3->guid, 'test_relationship'));
     $r = check_entity_relationship($this->entity1->guid, 'test_relationship', $this->entity3->guid);
     $this->assertIsA($r, 'ElggRelationship');
     $this->assertTrue($this->entity3->addRelationship($this->entity1->guid, 'test_relationship'));
     $r = check_entity_relationship($this->entity3->guid, 'test_relationship', $this->entity1->guid);
     $this->assertIsA($r, 'ElggRelationship');
     $this->assertTrue($this->entity1->addRelationship($this->entity2->guid, 'test_relationship2'));
     $r = check_entity_relationship($this->entity1->guid, 'test_relationship2', $this->entity2->guid);
     $this->assertIsA($r, 'ElggRelationship');
     $this->assertTrue($this->entity1->addRelationship($this->entity3->guid, 'test_relationship2'));
     $r = check_entity_relationship($this->entity1->guid, 'test_relationship2', $this->entity3->guid);
     $this->assertIsA($r, 'ElggRelationship');
     $this->assertTrue($this->entity1->deleteRelationships());
     $this->assertFalse(check_entity_relationship($this->entity1->guid, 'test_relationship', $this->entity2->guid));
     $this->assertFalse(check_entity_relationship($this->entity1->guid, 'test_relationship', $this->entity3->guid));
     $this->assertFalse(check_entity_relationship($this->entity1->guid, 'test_relationship2', $this->entity2->guid));
     $this->assertFalse(check_entity_relationship($this->entity1->guid, 'test_relationship2', $this->entity3->guid));
     // inverse relationships should be gone too
     $this->assertFalse(check_entity_relationship($this->entity3->guid, 'test_relationship', $this->entity1->guid));
 }