io.github.oliviercailloux.j_voting.profiles.StrictProfileI Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of j-voting Show documentation

General classes for dealing with social choice theory.

The newest version!

package io.github.oliviercailloux.j_voting.profiles;

import java.io.IOException;
import java.io.OutputStream;
import java.util.List;

import io.github.oliviercailloux.j_voting.OldLinearPreferenceImpl;
import io.github.oliviercailloux.j_voting.Voter;

/**
 * A StrictProfileI represents an incomplete StrictProfile. The preferences are
 * strict. The preferences are not necessarily about the same alternatives.
 *
 */
public interface StrictProfileI extends ProfileI {

	/**
	 * 
	 * @param v a voter not null
	 * @return the StrictPreference of the voter v in the profile.
	 */
	@Override
	public OldLinearPreferenceImpl getPreference(Voter v);

	@Override
	public default boolean isStrict() {
		return true;
	}

	/**
	 * 
	 * @param i the index of the alternatives to get
	 * @return a list of strings containing the ith alternatives in the profile. If
	 *         the preference doesn't have an ith alternative, it adds an empty
	 *         string to the list.
	 */
	public List getIthAlternativesAsStrings(int i);

	/**
	 * 
	 * @param i
	 * @return a list of strings of the ith alternatives of the unique preferences.
	 *         If the preference doesn't have an ith alternative, it adds an empty
	 *         string to the list.
	 */
	public List getIthAlternativesOfUniquePrefAsString(int i);

	/**
	 * 
	 * @param output the outputstream to write the soi profile
	 */
	public void writeToSOI(OutputStream output) throws IOException;
}