.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "BITMAP_SCNLISTPRINTF" "9" "09 October 2005" "" ""

.SH NAME
bitmap_scnlistprintf \- convert bitmap to list format ASCII string
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int bitmap_scnlistprintf  (char * \fIbuf\fB, unsigned int \fIbuflen\fB, const unsigned long * \fImaskp\fB, int \fInmaskbits\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIbuf\fB\fR
byte buffer into which string is placed
.TP
\fB\fIbuflen\fB\fR
reserved size of \fIbuf\fR, in bytes
.TP
\fB\fImaskp\fB\fR
pointer to bitmap to convert
.TP
\fB\fInmaskbits\fB\fR
size of bitmap, in bits
.SH "DESCRIPTION"
.PP
Output format is a comma-separated list of decimal numbers and
ranges.  Consecutively set bits are shown as two hyphen-separated
decimal numbers, the smallest and largest bit numbers set in
the range.  Output format is compatible with the format
accepted as input by \fBbitmap_parselist\fR\&.
.PP
The return value is the number of characters which would be
generated for the given input, excluding the trailing '\\0', as
per ISO C99.