net.automatalib.incremental.dfa.dag.State Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of automata-incremental Show documentation

A library for incremental automata construction. This artifact contains algorithms for incrementally constructing DFAs (prefix-closed and non-prefix-closed), Mealy machines, and Moore machines from a finite, incrementally growing set of example inputs/outputs.

There is a newer version: 0.12.0

Show newest version

/* Copyright (C) 2013 TU Dortmund
 * This file is part of AutomataLib, http://www.automatalib.net/.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *     http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package net.automatalib.incremental.dfa.dag;

import net.automatalib.incremental.dfa.Acceptance;

/**
 * State data structure. Note that states are generally unique throughout the algorithm,
 * hence comparisons are always identity comparisons.
 * 
 * @author Malte Isberner 
 * 
 */
final class State {
	private int numIncoming;
	private final StateSignature signature;
	
	/**
	 * Constructor. Initializes the state with a given signature
	 * @param signature the signature
	 */
	public State(StateSignature signature) {
		this.signature = signature;
		this.numIncoming = 0;
	}
	
	/**
	 * Increases the number of incoming transitions.
	 */
	public void increaseIncoming() {
		numIncoming++;
	}
	
	/**
	 * Decreases the number of incoming transitions.
	 */
	public void decreaseIncoming() {
		numIncoming--;
	}
	
	/**
	 * Checks whether this node is a confluence node (i.e. has more than one incoming
	 * transitions)
	 * @return true if this node is a confluence node, false otherwise.
	 */
	public boolean isConfluence() {
		return (numIncoming > 1);
	}
	
	/**
	 * Retrieves the ternary acceptance status of this node.
	 * @return the acceptance status of this node.
	 */
	public Acceptance getAcceptance() {
		if(signature == null) {
			return Acceptance.FALSE;
		}
		return signature.acceptance;
	}
	
	/**
	 * Retrieves the successor for the given input index
	 * @param idx the input index
	 * @return the successor state for the given index
	 */
	public State getSuccessor(int idx) {
		return signature.successors[idx];
	}
	
	/**
	 * Retrieves the signature of this state
	 * @return the state's signature
	 */
	public StateSignature getSignature() {
		return signature;
	}

	public boolean isSink() {
		return (signature == null);
	}
	
	@Override
	public String toString() {
		if(isSink())
			return "sink";
		return "s";
	}
}