Struct Random

pub struct Random<T: Message> {
    pub output: OutputPort<T>,
    pub seed: Option<u64>,
}

A block for generating and sending a random value.

Block Diagram

block-beta
    columns 4
    Random space:2 Sink
    Random-- "output" -->Sink

    classDef block height:48px,padding:8px;
    classDef hidden visibility:none;
    class Random block
    class Sink hidden

Sequence Diagram

sequenceDiagram
    autonumber
    participant Random as Random block
    participant Random.output as Random.output port
    participant BlockA as Another block

    Random-->>BlockA: Connect

    Random->>BlockA: Message

    Random-->>Random.output: Close
    Random-->>BlockA: Disconnect

Examples

Using the block in a system

System::build(|s| {
    let random_generator = s.random::<u64>();
    let number_encoder = s.encode_lines();
    let stdout = s.write_stdout();
    s.connect(&random_generator.output, &number_encoder.input);
    s.connect(&number_encoder.output, &stdout.input);
});

Running the block via the CLI

$ protoflow execute Random

$ protoflow execute Random seed=42

Fields

output: OutputPort<T>

The port to send the value on.

seed: Option<u64>

A parameter for the random seed to use.

Implementations

impl<T: Message> Random<T>

pub fn new(output: OutputPort<T>) -> Self

pub fn with_params(output: OutputPort<T>, seed: Option<u64>) -> Self

Trait Implementations

impl<T: Message + Default> Block for Random<T>

fn execute(&mut self, runtime: &dyn BlockRuntime) -> BlockResult

Executes this block’s computation.

fn prepare(&mut self, _runtime: &dyn BlockRuntime) -> Result<(), BlockError>

Prepares this block for execution.

impl<T: Message> BlockDescriptor for Random<T>

fn inputs(&self) -> Vec<PortDescriptor>

A description of this block’s input ports.

fn outputs(&self) -> Vec<PortDescriptor>

A description of this block’s output ports.

fn parameters(&self) -> Vec<ParameterDescriptor>

A description of this block’s parameters.

impl<T: Clone + Message> Clone for Random<T>

fn clone(&self) -> Random<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Message> Definition for Random<T>

fn is_variation(&self) -> bool

impl<T: Message> Element for Random<T>

fn id(&self) -> Option<&str>

The unique element ID, if any.

fn alias_ids(&self) -> Vec<&str>

Various alternative identifiers for this Element.

fn name(&self) -> Option<&str>

The name of the element.

fn short_name(&self) -> Option<&str>

The short name of the element, if any.

fn is_library_element(&self) -> bool

Whether this Element is contained in the ownership tree of a library model.

fn owner(&self) -> Option<&dyn Element>

The owner of this Element, if any.

fn owning_namespace(&self) -> Option<&dyn Namespace>

The Namespace that owns this Element, if any.

fn owning_relationship(&self) -> Option<&dyn Relationship>

The Relationship for which this Element is an owned_related_element, if any.

fn qualified_name(&self) -> Option<QualifiedName>

impl<T: Message> MaybeLabeled for Random<T>

fn label(&self) -> Option<Cow<'_, str>>

Returns the human-readable label, if any, of the object.

fn is_labeled(&self) -> bool

Checks whether the object has a human-readable label.

impl<T: Message> MaybeNamed for Random<T>

fn name(&self) -> Option<Cow<'_, str>>

Returns the name, if any, of the object.

fn is_named(&self) -> bool

Checks whether the object has a name.

impl<T: Message> Namespace for Random<T>

fn names_of(&self, _element: &dyn Element) -> Vec<String>

impl<T: Message> OccurrenceDefinition for Random<T>

fn is_individual(&self) -> bool

impl StdioSystem for Random<u64>

fn build_system(config: StdioConfig) -> Result<System, StdioError>

impl<T: Message> Type for Random<T>

fn is_abstract(&self) -> bool

fn is_sufficient(&self) -> bool

fn is_conjugated(&self) -> bool

fn specializes(&self, _supertype: &Self) -> bool

impl<T: Message> BlockDefinition for Random<T>

impl<T: Message> Class for Random<T>

impl<T: Message> Classifier for Random<T>

impl<T: Message> ItemDefinition for Random<T>

impl<T: Message> PartDefinition for Random<T>

impl<T: Message> Structure for Random<T>