include/nana/L_times.h Source File

00001 /*
00002  * L_times.h - log measurements of time to a circular buffer.
00003  * 
00004  * Copyright (c) 1997 Phil Maker
00005  * All rights reserved.
00006  *
00007  * Redistribution and use in source and binary forms, with or without
00008  * modification, are permitted provided that the following conditions
00009  * are met:
00010  * 1. Redistributions of source code must retain the above copyright
00011  *    notice, this list of conditions and the following disclaimer.
00012  * 2. Redistributions in binary form must reproduce the above copyright
00013  *    notice, this list of conditions and the following disclaimer in the
00014  *    documentation and/or other materials provided with the distribution.
00015  *
00016  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
00017  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00018  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00019  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
00020  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
00021  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
00022  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
00023  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
00024  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
00025  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
00026  * SUCH DAMAGE.
00027  *
00028  * Id: L_times.h,v 1.2 1998/01/17 10:57:03 pjm Exp 
00029  */
00030 
00031 #ifndef _L_times_h_
00032 #define _L_times_h_ 1
00033 
00034 #ifdef __cplusplus
00035 extern "C" {
00036 #endif
00037 
00038 #ifndef _nana_config_h_
00039 #include <nana-config.h>
00040 #endif
00041 
00042 #include <stdio.h>
00043 #include <stdlib.h>
00044 
00045 #ifndef NANA_TIME 
00046 #define NANA_TIME double
00047 #endif
00048 
00049 typedef struct {
00050   unsigned long ncalls; /* total number of calls */
00051   unsigned long freeslot; /* current freeslot in times, names */
00052   unsigned long maxsamples; /* max samples to keep */
00053   int wraparound; /* wraparound (throw away old data) */
00054   NANA_TIME *times; /* the time for each event */
00055   char **names; /* the name for each event */
00056 } L_TIMES; 
00057 
00058 L_TIMES *L_times_create(unsigned long n);
00059 void L_times_delete(L_TIMES *l);
00060 void L_times_wraparound(L_TIMES *l, int wrap);
00061 void L_times_add(L_TIMES *l, char *n, NANA_TIME t);
00062 void L_times_clear(L_TIMES *l);
00063 void L_times_dump(L_TIMES *l, FILE *f);
00064 
00065 #ifdef __cplusplus
00066 }
00067 #endif
00068 
00069 #endif /* _L_times_h_ */
00070