copy

Class: slreportgen.report.Reporter
Namespace: slreportgen.report

Create copy of a Simulink reporter object and make deep copies of certain property values

Syntax

copiedObj = copy(reporterObj)


Description

copiedObj = copy(reporterObj) returns a copy of the specified reporter object. The returned copy contains a deep copy of any property value of reporterObj that references a reporter, DOM object, or slreportgen.report.ReporterLayout object.As a result, you can modify the properties of the original or new object without affecting the other object.

Input Arguments

reporterObj — Reporter to copy

reporter object

Reporter to copy, specified as an object of a reporter class.

Output Arguments

copiedObj — Copy of reporter

reporter object

Copy of reporter, returned as an object of a reporter class.

Examples

Copy a Simulink Reporter Object

This example copies a DocBlock reporter to show the effect of a deep copy operation on a reporter property. Modifying a property of the Text object in the TextFormatter property of the copy of the DocBlock object does not affect the original DocBlock object.

Load a model.

import slreportgen.report.*

model_name = "sldemo_fuelsys";
load_system(model_name);
docBlock = "sldemo_fuelsys/To Controller/Sensor Info";

Create a DocBlock reporter.

rptr1 = DocBlock(docBlock);

The Bold property of the Text object referenced by the TextFormatter property of the reporter is empty.

rptr1.TextFormatter.Bold

ans =

     []

Copy the DocBlock object. In the copy, set the Bold property of the Text object referenced by the TextFormatter property to true.

rptr2 = copy(rptr1);
rptr2.TextFormatter.Bold = true;
rptr2.TextFormatter.Bold

ans = logical
   1

In the original DocBlock object, the Bold property of the object referenced by the TextFormatter property is still empty.

rptr1.TextFormatter.Bold

ans =

     []

More About

reporter class

A reporter class is a Report API class that is a subclass of the mlreportgen.report.ReporterBase class, which is an undocumented, internal class.

deep copy

To make a deep copy of a handle object, the copy operation recursively copies property values that are handles to objects so that all of the underlying data is copied. By contrast, with a shallow copy, the copy operation copies the handle. The underlying data is not copied. When you copy a reporter, the copy operation makes a deep copy of any property value that is a reporter object, or a DOM object.

Version History

Introduced in R2021a