1. NAME

bitmap_scnlistprintf - convert bitmap to list format ASCII string

2. SYNOPSIS

int bitmap_scnlistprintf(char *  buf , unsigned int  buflen , const unsigned long *  maskp , int  nmaskbits );

3. ARGUMENTS

buf
    byte buffer into which string is placed

buflen
    reserved size of buf, in bytes

maskp
    pointer to bitmap to convert

nmaskbits
    size of bitmap, in bits

4. DESCRIPTION

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 bitmap_parselist.

The return value is the number of characters which were written to *buf excluding the trailing Aq\0Aq, as per ISO C99Aqs scnprintf.

5. COPYRIGHT