Struct Audience 

pub struct Audience { /* private fields */ }

An audience is a strict partial order over values, represented as ranked tiers. Each inner Vec<Value> is one tier; values within a tier are equally preferred. Earlier tiers are strictly more preferred than later tiers.

Examples

use argumentation_values::{Audience, Value};
let life = Value::new("life");
let property = Value::new("property");

// Total order: life > property
let strict = Audience::total([life.clone(), property.clone()]);
assert!(strict.prefers(&life, &property));
assert!(!strict.prefers(&property, &life));

// Incomparable values
let flat = Audience::from_tiers(vec![vec![life.clone(), property.clone()]]);
assert!(!flat.prefers(&life, &property));
assert!(!flat.prefers(&property, &life));

Implementations

impl Audience

pub fn new() -> Self

Construct an empty audience (no preferences — all attacks survive).

pub fn total<I: IntoIterator<Item = Value>>(ranked: I) -> Self

Construct a total ordering from an iterator of values, most preferred first.

pub fn from_tiers(tiers: Vec<Vec<Value>>) -> Self

Construct from explicit ranked tiers. Each inner vec is one tier of equally preferred values.

pub fn prefers(&self, a: &Value, b: &Value) -> bool

Returns true iff a is strictly preferred to b under this audience. Returns false if either value is unranked (incomparable).

pub fn rank(&self, v: &Value) -> Option<usize>

0-indexed tier of v (0 = most preferred), or None if v is unranked (not mentioned in any tier).

Public so consumers (e.g., ValueAwareScorer) can compute boost magnitudes without re-implementing the lookup.

pub fn values(&self) -> impl Iterator<Item = &Value>

Iterate the distinct values mentioned in this audience.

pub fn value_count(&self) -> usize

Number of distinct values in this audience.

pub fn tier_count(&self) -> usize

Number of tiers (rank levels).

Trait Implementations

impl Clone for Audience

fn clone(&self) -> Audience

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Audience

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Audience

fn default() -> Audience

Returns the “default value” for a type.