'Stop collection of matching stanzas, and return the ones that
have been stored so far.'

def stop(self):

    self._destroy = True
    results = []
    try:
        while True:
            results.append(self._payload.get(False))
    except QueueEmpty:
        pass
    self.stream().remove_handler(self.name)
    return results
