Hash_PrintStats — C Library Procedures

NAME

Hash_PrintStats − print statistics about a hash table

SYNOPSIS

#include <hash.h> Hash_PrintStats(tablePtr, proc, clientData)

ARGUMENTS

Hash_Table ∗tablePtr (in) Table about which to print information.

void (∗proc)() (in) Procedure to call to actually print information.

ClientData clientData (in) Arbitrary additional argument to be passed to proc.

DESCRIPTION

Hash_PrintStats prints out statistical information about bucket usage in tablePtr. The information includes the total number of buckets and entries in the table, plus a histogram indicating how many buckets have each different number of entries in them.

Hash_PrintStats does not output the statistics information directly. Instead, it invokes proc to do the output. Proc must have the following calling sequence: void proc(clientData, string) ClientData clientData; char ∗string; { }

The clientData parameter will be the same as the clientData to Hash_PrintStats; ostensibly it provides information to help proc perform the actual I/O, such as channel number. String is a NULL-terminated string of characters containing the statistical information. Proc may be invoked many times during a single call to Hash_PrintStats.

KEYWORDS

hash table, print, statistics