01: //
02: // Copyright (C) 2005 United States Government as represented by the
03: // Administrator of the National Aeronautics and Space Administration
04: // (NASA). All Rights Reserved.
05: //
06: // This software is distributed under the NASA Open Source Agreement
07: // (NOSA), version 1.3. The NOSA has been approved by the Open Source
08: // Initiative. See the file NOSA-1.3-JPF at the top of the distribution
09: // directory tree for the complete NOSA document.
10: //
11: // THE SUBJECT SOFTWARE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY OF ANY
12: // KIND, EITHER EXPRESSED, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT
13: // LIMITED TO, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL CONFORM TO
14: // SPECIFICATIONS, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR
15: // A PARTICULAR PURPOSE, OR FREEDOM FROM INFRINGEMENT, ANY WARRANTY THAT
16: // THE SUBJECT SOFTWARE WILL BE ERROR FREE, OR ANY WARRANTY THAT
17: // DOCUMENTATION, IF PROVIDED, WILL CONFORM TO THE SUBJECT SOFTWARE.
18: //
19: package gov.nasa.jpf.jvm;
20:
21: /**
22: * interface to encapsulate an ADT (conceptually a set) used to answer if
23: * a state has been seen already
24: */
25: public interface StateSet {
26:
27: static final int UNKNOWN_ID = -1;
28:
29: /**
30: * check if a state is already in the set, and add it if not. Answer
31: * it's numeric id
32: */
33: int add(SystemState ss);
34:
35: /**
36: * how many states do we already have in the set
37: */
38: int size();
39:
40: /**
41: * for a given state id (obtained by add), tell us if the last add() call
42: * inserted this (i.e. it was a new state)
43: */
44: boolean isNewState(int stateId);
45: }
|