Package it.unimi.di.prog2.temisvolti.boolvect

Interface BoolVect

All Known Implementing Classes:
AbstractBoolVect, ArrayBoolVect, LongBoolVect, SetBoolVect
public interface BoolVect
Interfaccia che stabilisce li contratto dei BoolVect.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    and(BoolVect other)
    Rende questo BoolVect uguale all'and componente a componente di questo BoolVect e quello specificato.
    default void
    daString(String vals)
    Rende il BoolVect uguale ai valori di verità specificati nella stringa data.
    int
    dimensione()
    Restituisce la dimensione del BoolVect.
    boolean
    leggi(int pos)
    Legge il valore di verità di posizione specificata.
    void
    or(BoolVect other)
    Rende questo BoolVect uguale all'or componente a componente di questo BoolVect e quello specificato.
    void
    pulisci()
    Rende false tutti i valori di verità del BoolVect.
    void
    scrivi(int pos, boolean val)
    Scrive il valore di verità dato nella posizione specificata.
    int
    taglia()
    Restituisce la taglia del BoolVect.
    void
    xor(BoolVect other)
    Rende questo BoolVect uguale allo xor componente a componente di questo BoolVect e quello specificato.

  • Method Details

    • dimensione

      int dimensione()
      Restituisce la dimensione del BoolVect.

      La dimensione del BoolVect è il più grande intero d tale che il valore di verità in posizione d - 1 del BoolVect è è true. La dimensione ha un valore compreso tra 0 e la taglia (estremi inclusi).

      Returns:
      la dimensione.

    • taglia

      int taglia()
      Restituisce la taglia del BoolVect.

      La taglia del BoolVect è il massimo valore possibile per la sua dimensione; detto altrimenti, è il più grande intero d per cui il valore di verità di posizione d - 1 può essere true. La taglia è un numero positivo sempre maggiore o uguale alla dimensione e vale convenzionalmente Integer.MAX_VALUE se la dimensione non è limitata.

      Returns:
      la taglia.

    • leggi

      boolean leggi(int pos) throws IndexOutOfBoundsException
      Legge il valore di verità di posizione specificata.

      Se la posizione eccede la dimensione (o la taglia) verrà restituito convenzionalmente il valore false.

      Parameters:
      pos - la posizione.
      Returns:
      il valore di verità.
      Throws:
      IndexOutOfBoundsException - se la posizione è negativa.

    • scrivi

      void scrivi(int pos, boolean val) throws IndexOutOfBoundsException
      Scrive il valore di verità dato nella posizione specificata.
      Parameters:
      pos - la posizione.
      val - il valore di verità
      Throws:
      IndexOutOfBoundsException - se la posizione è negativa, o il valore è true e la posizione è maggiore o uguale alla taglia.

    • and

      void and(BoolVect other) throws NullPointerException
      Rende questo BoolVect uguale all'and componente a componente di questo BoolVect e quello specificato.

      Si osservi che, sebbene la dimensione degli operandi può essere diversa, in nessun caso la dimensione del risultato può eccedere la minore tra le due; l'and infatti è senz'altro false per tutte le posizioni che sono maggiori della dimensione di uno, o dell'altro, BoolVect booleano.

      Parameters:
      other - l'altro BoolVect.
      Throws:
      NullPointerException - se l'agromento è null.

    • or

      void or(BoolVect other) throws NullPointerException, IllegalArgumentException
      Rende questo BoolVect uguale all'or componente a componente di questo BoolVect e quello specificato.

      Si osservi che se la dimensione dell'altro BoolVect è maggiore della taglia (e quindi dimensione) di questo, allora il valore di verità in posizione pari alla dimensione dell'altro BoolVect sarà true, ma non potrà essere memorizzato in questo BoolVect per via della sua taglia.

      Parameters:
      other - l'altro BoolVect.
      Throws:
      IllegalArgumentException - se la taglia di questo BoolVect è minore della dimensione del risultato.
      NullPointerException - se l'agromento è null.

    • xor

      void xor(BoolVect other) throws NullPointerException, IllegalArgumentException
      Rende questo BoolVect uguale allo xor componente a componente di questo BoolVect e quello specificato.

      Si osservi che se la dimensione dell'altro BoolVect è maggiore della taglia (e quindi dimensione) di questo, allora il valore di verità in posizione pari alla dimensione dell'altro BoolVect sarà true, ma non potrà essere memorizzato in questo BoolVect per via della sua taglia.

      Parameters:
      other - l'altro BoolVect.
      Throws:
      IllegalArgumentException - se la taglia di questo BoolVect è minore della dimensione del risultato.
      NullPointerException - se l'agromento è null.

    • pulisci

      void pulisci()
      Rende false tutti i valori di verità del BoolVect.

    • daString

      default void daString(String vals) throws NullPointerException, IllegalArgumentException
      Rende il BoolVect uguale ai valori di verità specificati nella stringa data.

      La stringa può contenere qualunque carattere, l'i-esimo valore di verità del BoolVect sarà true se e solo se l'i-esimo carattere della stringa (contando da destra) è `V`.

      Parameters:
      vals - la stringa dei valori di verità.
      Throws:
      IllegalArgumentException - se la stringa è più lunga della taglia del BoolVect.
      NullPointerException - se l'agromento è null.