mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-11-02 11:21:12 +00:00
0711c4b74d
Sometimes it's handy to know how many bits are set. * src/util/bitmap.h (virBitmapCountBits): New prototype. (virBitmapNextSetBit): Use correct type. * src/util/bitmap.c (virBitmapNextSetBit): Likewise. (virBitmapSetAll): Maintain invariant of clear tail bits. (virBitmapCountBits): New function. * src/libvirt_private.syms (bitmap.h): Export it. * tests/virbitmaptest.c (test2): Test it.
110 lines
3.0 KiB
C
110 lines
3.0 KiB
C
/*
|
|
* bitmap.h: Simple bitmap operations
|
|
*
|
|
* Copyright (C) 2012 Red Hat, Inc.
|
|
* Copyright (C) 2010 Novell, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see
|
|
* <http://www.gnu.org/licenses/>.
|
|
*
|
|
* Author: Jim Fehlig <jfehlig@novell.com>
|
|
*/
|
|
|
|
#ifndef __BITMAP_H__
|
|
# define __BITMAP_H__
|
|
|
|
# include "internal.h"
|
|
|
|
# include <sys/types.h>
|
|
|
|
|
|
typedef struct _virBitmap virBitmap;
|
|
typedef virBitmap *virBitmapPtr;
|
|
|
|
/*
|
|
* Allocate a bitmap capable of containing @size bits.
|
|
*/
|
|
virBitmapPtr virBitmapNew(size_t size) ATTRIBUTE_RETURN_CHECK;
|
|
|
|
/*
|
|
* Free previously allocated bitmap
|
|
*/
|
|
void virBitmapFree(virBitmapPtr bitmap);
|
|
|
|
/*
|
|
* Copy all bits from @src to @dst. The bitmap sizes
|
|
* must be the same
|
|
*/
|
|
int virBitmapCopy(virBitmapPtr dst, virBitmapPtr src);
|
|
|
|
/*
|
|
* Set bit position @b in @bitmap
|
|
*/
|
|
int virBitmapSetBit(virBitmapPtr bitmap, size_t b)
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_RETURN_CHECK;
|
|
|
|
/*
|
|
* Clear bit position @b in @bitmap
|
|
*/
|
|
int virBitmapClearBit(virBitmapPtr bitmap, size_t b)
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_RETURN_CHECK;
|
|
|
|
/*
|
|
* Get setting of bit position @b in @bitmap and store in @result
|
|
*/
|
|
int virBitmapGetBit(virBitmapPtr bitmap, size_t b, bool *result)
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(3) ATTRIBUTE_RETURN_CHECK;
|
|
|
|
char *virBitmapString(virBitmapPtr bitmap)
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_RETURN_CHECK;
|
|
|
|
char *virBitmapFormat(virBitmapPtr bitmap)
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
int virBitmapParse(const char *str,
|
|
char sep,
|
|
virBitmapPtr *bitmap,
|
|
size_t bitmapSize)
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(3);
|
|
|
|
virBitmapPtr virBitmapNewCopy(virBitmapPtr src) ATTRIBUTE_NONNULL(1);
|
|
|
|
virBitmapPtr virBitmapNewData(void *data, int len) ATTRIBUTE_NONNULL(1);
|
|
|
|
int virBitmapToData(virBitmapPtr bitmap, unsigned char **data, int *dataLen)
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
bool virBitmapEqual(virBitmapPtr b1, virBitmapPtr b2)
|
|
ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(2);
|
|
|
|
size_t virBitmapSize(virBitmapPtr bitmap)
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
void virBitmapSetAll(virBitmapPtr bitmap)
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
void virBitmapClearAll(virBitmapPtr bitmap)
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
bool virBitmapIsAllSet(virBitmapPtr bitmap)
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
ssize_t virBitmapNextSetBit(virBitmapPtr bitmap, ssize_t pos)
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
size_t virBitmapCountBits(virBitmapPtr bitmap)
|
|
ATTRIBUTE_NONNULL(1);
|
|
|
|
#endif
|