contrib/bind/lib/dns/rdatasetiter.c

   1 /*
   2  * Copyright (C) 2004, 2005, 2007  Internet Systems Consortium, Inc. ("ISC")
   3  * Copyright (C) 1999-2001  Internet Software Consortium.
   4  *
   5  * Permission to use, copy, modify, and/or distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  10  * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  11  * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  12  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  13  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  14  * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  15  * PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 /* $Id: rdatasetiter.c,v 1.16 2007/06/19 23:47:16 tbox Exp $ */
  19
  20 /*! \file */
  21
  22 #include <config.h>
  23
  24 #include <stddef.h>
  25
  26 #include <isc/util.h>
  27
  28 #include <dns/rdataset.h>
  29 #include <dns/rdatasetiter.h>
  30
  31 void
  32 dns_rdatasetiter_destroy(dns_rdatasetiter_t **iteratorp) {
  33         /*
  34          * Destroy '*iteratorp'.
  35          */
  36
  37         REQUIRE(iteratorp != NULL);
  38         REQUIRE(DNS_RDATASETITER_VALID(*iteratorp));
  39
  40         (*iteratorp)->methods->destroy(iteratorp);
  41
  42         ENSURE(*iteratorp == NULL);
  43 }
  44
  45 isc_result_t
  46 dns_rdatasetiter_first(dns_rdatasetiter_t *iterator) {
  47         /*
  48          * Move the rdataset cursor to the first rdataset at the node (if any).
  49          */
  50
  51         REQUIRE(DNS_RDATASETITER_VALID(iterator));
  52
  53         return (iterator->methods->first(iterator));
  54 }
  55
  56 isc_result_t
  57 dns_rdatasetiter_next(dns_rdatasetiter_t *iterator) {
  58         /*
  59          * Move the rdataset cursor to the next rdataset at the node (if any).
  60          */
  61
  62         REQUIRE(DNS_RDATASETITER_VALID(iterator));
  63
  64         return (iterator->methods->next(iterator));
  65 }
  66
  67 void
  68 dns_rdatasetiter_current(dns_rdatasetiter_t *iterator,
  69                          dns_rdataset_t *rdataset)
  70 {
  71         /*
  72          * Return the current rdataset.
  73          */
  74
  75         REQUIRE(DNS_RDATASETITER_VALID(iterator));
  76         REQUIRE(DNS_RDATASET_VALID(rdataset));
  77         REQUIRE(! dns_rdataset_isassociated(rdataset));
  78
  79         iterator->methods->current(iterator, rdataset);
  80 }