modified

Class: matlab.DiscreteEventSystem
Namespace: matlab

Event action upon entity modification by the Entity Find block

Syntax

[events] = modified(obj,storage,entity)
[events, out1, ...] = modified(obj,storage,entity,in1,...)


Description

[events] = modified(obj,storage,entity) specifies event actions of the object after an entity is modified.

[events, out1, ...] = modified(obj,storage,entity,in1,...) specifies event actions of the object when the block has one or more input signal ports and/or signal output ports.

Input Arguments

obj — Discrete-event System object™

MATLAB^® object

Discrete-event System object.

storage — Storage

double

Index of the storage element where the entity is being modified.

entity — Entity

MATLAB structure

Entity that is being modified. Entity has these fields:

• sys (MATLAB structure) — It has these fields:

  • id (double) — Entity ID

  • priority (double) — Entity priority

• data — Entity data

in1 — Signal input

any value

Any data inputs of the object. These input arguments exist only when the object has data inputs.

Output Arguments

events — Events

vector of MATLAB structures

Events to be scheduled after the method returns. Use matlab.DiscreteEventSystem class methods to create events. Each event has these fields:

• type (character vector) — Type of the event

• delay (double) — Delay before the event

• priority (double) — Priority of the event

• Storage (double) — Index of the storage element

• tag (character vector) — Event tag

• location (MATLAB structure) — Source or destination location of entity

out1 — Signal output

any value

Data outputs of the object. You must specify these output arguments when the object has data outputs.

Examples

Event Action Upon Entity Modification

Specify event action to be performed after entity modification in a storage

function events = modified(obj,storage,entity)
    events = [];
    % If the delay attribute of the entity exceeds 100,
    % destroy the entity
    if entity.data.delay > 100
    events = obj.destroy();
    end
end
   

Version History

Introduced in R2018b