STATS(OC)

Shore Programmer's Manual - 3 November 94

NAME

stats \- application statistics gathering

SYNOPSIS

#include <ShoreApp.h>
void Shore::get_stats(AppStats *stats, bool clear = false);
void Shore::clear_stats();

DESCRIPTION

These methods are the interface to a statistics-gathering facility that application programmers may find useful for debugging or performance-tuning purposes.

Get_stats fills in the AppStats structure given by stats with the current statistics. If clear is "true", then all statistics are reset to zero. Clear_stats resets the statistics to zero after begin copied.

Shore::init (see init(oc) ) initializes the statistics to zero. After initialization, the statistics are never reset, unless explicitly requested by the application via calls to get_stats or clear_stats.

The AppStats structure, defined in OCTypes.h, looks like this:

    struct AppStats
    {
        int anoncreates;
        int regcreates;
        int ncached;
        int nupdates;
        int ndestroys;
    };
The fields of AppStats are:

anoncreates: the number of anonymous objects created.

regcreates: the number of registered object created.

ncached: the number of fetch operations performed.

nupdates: the number of objects updated.

ndestroys: the number of objects destroyed.

VERSION

This manual page applies to Version 0.1 of theShore software.

SPONSORSHIP

The Shore project is sponsored by the Advanced Research Project Agency, ARPA order number 018 (formerly 8230), monitored by the U.S. Army Research Laboratory under contract DAAB07-91-C-Q518.

COPYRIGHT

Copyright (c) 1994 Computer Sciences Department, University of Wisconsin -- Madison. All Rights Reserved.

SEE ALSO

create(oc) , destroy(oc) , fetch(oc) , init(oc) , method(oc) , new(sdl) , update(oc) .