/* Copyright 2016 Alex 'AdUser' Z (ad_user@runbox.com)
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation.
 */
#ifndef F2B_MATCHES_H_
#define F2B_MATCHES_H_

/**
 * @file
 * This file contains definition of ipaddr matches struct and related routines
 */

typedef struct f2b_match_t {
  struct f2b_match_t *next;
  time_t time;
  /* more fields? */
} f2b_match_t;

/** matches container */
typedef struct {
  size_t count;  /**< Count of entries in linked list */
  time_t last;   /**< latest match time */
  f2b_match_t *list; /**< linked list  */
} f2b_matches_t;

/**
 * @brief Allocate memory for new match struct & initialize it
 * @param t Match time
 * @returns pointer to allocated struct
 */
f2b_match_t * f2b_match_create(time_t t);

/**
 * @brief Clean list of matches and free memory
 * @param ms Pointer to struct
 */
void f2b_matches_flush(f2b_matches_t *ms);

/**
 * @brief Push new match time to struct
 * @param m Pointer to struct
 * @param time Match time
 * @param score Match score
 * @returns true on success, false if capacity exceeded
 */
void f2b_matches_append (f2b_matches_t *ms, f2b_match_t *m);

/**
 * @brief Remove matches before given time
 * @param m Pointer to struct
 * @param before Start time
 */
void f2b_matches_expire (f2b_matches_t *m, time_t before);

#endif /* F2B_MATCHES_H_ */