Struct BasicBelief 

pub struct BasicBelief { /* private fields */ }

An implementation of Belief.

Implementations

impl BasicBelief

pub fn new(name: String) -> Self

Create a new BasicBelief with random Uuid.

Arguments

• name: The name of the BasicBelief.

Returns

The new BasicBelief with a Uuid generated using uuid::Uuid::new_v4.

Examples

use belief_spread::BasicBelief;

let b = BasicBelief::new("Belief 1".to_string());

pub fn new_with_uuid(name: String, uuid: Uuid) -> Self

Create a new BasicBelief with specified Uuid.

Arguments

• name: The name of the BasicBelief.
• uuid: The Uuid of the BasicBelief.

Returns

The new BasicBelief.

Examples

use belief_spread::BasicBelief;
use uuid::Uuid;

let b = BasicBelief::new_with_uuid("Belief 1".to_string(), Uuid::new_v4());

Trait Implementations

impl Belief for BasicBelief

fn get_perception(&self, behaviour: &BehaviourPtr) -> Option<f64>

Gets the perception, returning a f64 if found.

The perception is the amount an agent performing the behaviour can be assumed to be driven by this belief.

This is a value between -1 and +1.

Arguments

• behaviour: The behaviour.

Returns

The value, if found.

Examples

use belief_spread::{BasicBelief, BasicBehaviour, Belief, BehaviourPtr};

let mut b = BasicBelief::new("Belief 1".to_string());
let behaviour = BasicBehaviour::new("Behaviour 1".to_string());
let beh_ptr: BehaviourPtr = behaviour.into();
b.set_perception(beh_ptr.clone(), Some(0.1));
assert_eq!(b.get_perception(&beh_ptr).unwrap(), 0.1);

fn set_perception( &mut self, behaviour: BehaviourPtr, perception: Option<f64>, ) -> Result<(), OutOfRangeError>

Sets the perception.

The perception is the amount an agent performing the behaviour can be assumed to be driven by this belief.

Deletes a behaviour if no perception is supplied.

This is a value between -1 and +1.

Arguments

• behaviour: The BehaviourPtr.
• perception: The new perception.

Returns

A Result, Ok if nothing is wrong, or an Err with a OutOfRangeError, if the perception is not in range [-1, +1].

Examples

use belief_spread::{BasicBelief, BasicBehaviour, Belief, BehaviourPtr};

let mut b = BasicBelief::new("Belief 1".to_string());
let behaviour = BasicBehaviour::new("Behaviour 1".to_string());
let beh_ptr: BehaviourPtr = behaviour.into();
b.set_perception(beh_ptr.clone(), Some(0.1));
assert_eq!(b.get_perception(&beh_ptr).unwrap(), 0.1);

fn get_relationship(&self, belief: &BeliefPtr) -> Option<f64>

Gets the relationship, returning a f64 if found.

The relationship is the amount another belief can be deemed to be compatible with holding this belief, given that you already hold this belief.

This is a value between -1 and +1.

Arguments

• belief: The other Belief.

Returns

The value, if found.

Examples

use belief_spread::{BasicBelief, BasicBehaviour, Belief, UUIDd, Named, BeliefPtr};

let mut b = BasicBelief::new("Belief 1".to_string());
let b2 = BasicBelief::new("Belief 2". to_string());
let b2_ptr: BeliefPtr = b2.into();
b.set_relationship(b2_ptr.clone(), Some(0.1));
assert_eq!(b.get_relationship(&b2_ptr).unwrap(), 0.1);

fn set_relationship( &mut self, belief: BeliefPtr, relationship: Option<f64>, ) -> Result<(), OutOfRangeError>

Sets the relationship.

The relationship is the amount another belief can be deemed to be compatible with holding this belief, given that you already hold this belief.

Deletes a belief is no relationship is supplied.

This is a value between -1 and +1.

Arguments

• belief: The other Belief.
• relationship: The new relationship

Returns

A Result, Ok if nothing is wrong, or an Err with a OutOfRangeError, if the relationship is not in range [-1, +1].

Examples

use belief_spread::{BasicBelief, BasicBehaviour, Belief, UUIDd, Named, BeliefPtr};

let mut b = BasicBelief::new("Belief 1".to_string());
let b2 = BasicBelief::new("Belief 2". to_string());
let b2_ptr: BeliefPtr = b2.into();
b.set_relationship(b2_ptr.clone(), Some(0.1));
assert_eq!(b.get_relationship(&b2_ptr).unwrap(), 0.1);

impl Clone for BasicBelief

fn clone(&self) -> BasicBelief

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BasicBelief

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

Formats the value using the given formatter.

impl From<BasicBelief> for BeliefPtr

fn from(b: BasicBelief) -> Self

Convert from a BasicBelief into a BeliefPtr.

This consumes the BasicBelief.

Arguments

• b: The BasicBelief to convert.

Returns

The BeliefPtr.

Examples

use belief_spread::{BasicBelief, BeliefPtr};

let b = BasicBelief::new("Belief 1".to_string());
let b_ptr = BeliefPtr::from(b);

use belief_spread::{BasicBelief, BeliefPtr};

let b = BasicBelief::new("Belief 1".to_string());
let b_ptr: BeliefPtr = b.into();

impl Hash for BasicBelief

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Named for BasicBelief

fn name(&self) -> &str

Get the name of the BasicBelief.

fn set_name(&mut self, name: String)

Set the name of the BasicBelief.

impl PartialEq for BasicBelief

fn eq(&self, other: &Self) -> bool

Compare if two BasicBeliefs are equal, solely by their UUID.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl UUIDd for BasicBelief

fn uuid(&self) -> &Uuid

Get the UUID of the BasicBelief.

fn set_uuid(&mut self, u: Uuid)

Set the UUID of the BasicBelief.

impl Eq for BasicBelief