/contrib/bind9/lib/isc/include/isc/region.h
https://bitbucket.org/freebsd/freebsd-head/ · C++ Header · 99 lines · 46 code · 14 blank · 39 comment · 3 complexity · a9325b148e3c10325cfb90ac78646142 MD5 · raw file
- /*
- * Copyright (C) 2004-2007 Internet Systems Consortium, Inc. ("ISC")
- * Copyright (C) 1998-2002 Internet Software Consortium.
- *
- * Permission to use, copy, modify, and/or distribute this software for any
- * purpose with or without fee is hereby granted, provided that the above
- * copyright notice and this permission notice appear in all copies.
- *
- * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
- * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
- * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
- * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
- * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
- * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- * PERFORMANCE OF THIS SOFTWARE.
- */
- /* $Id: region.h,v 1.25 2007/06/19 23:47:18 tbox Exp $ */
- #ifndef ISC_REGION_H
- #define ISC_REGION_H 1
- /*! \file isc/region.h */
- #include <isc/types.h>
- struct isc_region {
- unsigned char * base;
- unsigned int length;
- };
- struct isc_textregion {
- char * base;
- unsigned int length;
- };
- /* XXXDCL questionable ... bears discussion. we have been putting off
- * discussing the region api.
- */
- struct isc_constregion {
- const void * base;
- unsigned int length;
- };
- struct isc_consttextregion {
- const char * base;
- unsigned int length;
- };
- /*@{*/
- /*!
- * The region structure is not opaque, and is usually directly manipulated.
- * Some macros are defined below for convenience.
- */
- #define isc_region_consume(r,l) \
- do { \
- isc_region_t *_r = (r); \
- unsigned int _l = (l); \
- INSIST(_r->length >= _l); \
- _r->base += _l; \
- _r->length -= _l; \
- } while (0)
- #define isc_textregion_consume(r,l) \
- do { \
- isc_textregion_t *_r = (r); \
- unsigned int _l = (l); \
- INSIST(_r->length >= _l); \
- _r->base += _l; \
- _r->length -= _l; \
- } while (0)
- #define isc_constregion_consume(r,l) \
- do { \
- isc_constregion_t *_r = (r); \
- unsigned int _l = (l); \
- INSIST(_r->length >= _l); \
- _r->base += _l; \
- _r->length -= _l; \
- } while (0)
- /*@}*/
- int
- isc_region_compare(isc_region_t *r1, isc_region_t *r2);
- /*%<
- * Compares the contents of two regions
- *
- * Requires:
- *\li 'r1' is a valid region
- *\li 'r2' is a valid region
- *
- * Returns:
- *\li < 0 if r1 is lexicographically less than r2
- *\li = 0 if r1 is lexicographically identical to r2
- *\li > 0 if r1 is lexicographically greater than r2
- */
- #endif /* ISC_REGION_H */