Write message to status bar on saving syntax files
[pspp-builds.git] / src / data / casewindow.h
1 /* PSPP - a program for statistical analysis.
2    Copyright (C) 2007 Free Software Foundation, Inc.
3
4    This program is free software: you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation, either version 3 of the License, or
7    (at your option) any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program.  If not, see <http://www.gnu.org/licenses/>. */
16
17 /* Sliding window over a set of cases.
18
19    A casewindow is a queue of cases: cases may be added at the
20    head of the queue and deleted from the tail.  A casewindow is
21    initially maintained in memory and then, should it grow too
22    large, is dumped to disk.
23
24    Any case in the casewindow may be accessed, not just the case
25    at the head.  Cases are numbered relative to the tail: the
26    least recently added case is number 0, and so on. */
27
28 #ifndef DATA_CASEWINDOW_H
29 #define DATA_CASEWINDOW_H 1
30
31 #include <stddef.h>
32 #include <data/case.h>
33
34 struct casewindow *casewindow_create (size_t value_cnt,
35                                       casenumber max_in_core_cases);
36 bool casewindow_destroy (struct casewindow *);
37
38 void casewindow_push_head (struct casewindow *, struct ccase *);
39 void casewindow_pop_tail (struct casewindow *, casenumber cnt);
40 bool casewindow_get_case (const struct casewindow *, casenumber case_idx,
41                           struct ccase *);
42 size_t casewindow_get_value_cnt (const struct casewindow *);
43 casenumber casewindow_get_case_cnt (const struct casewindow *);
44
45 bool casewindow_error (const struct casewindow *);
46 void casewindow_force_error (struct casewindow *);
47 const struct taint *casewindow_get_taint (const struct casewindow *);
48
49 #endif /* data/casewindow.h */