target.remove - Remove target object from internal database - MATLAB (original) (raw)

Remove target object from internal database

Syntax

Description

target.remove([targetObject](#mw%5Fc0e2b1f2-5248-43d5-844e-b2521172c7c8)) removes the target object from an internal database.

example

target.remove([targetType](#mw%5F52432acd-e83e-4f6e-a13d-811a365f6f48), [targetObjectId](#mw%5F2cbd454d-b1db-40b7-af0f-54d77ecaab62)) removes the target object specified by class and identifier.

target.remove([targetObject](#mw%5Fc0e2b1f2-5248-43d5-844e-b2521172c7c8), [Name,Value](#namevaluepairarguments)) uses name-value arguments to remove associated objects and suppress command-line output.

Examples

collapse all

You can specify and add a hardware device implementation to an internal database.

armv8 = target.create('LanguageImplementation', ... 'Name', 'Armv8-A LP64', ... 'Copy', 'ARM Compatible-ARM Cortex');

a53 = target.create('Processor', ... 'Name', 'Cortex-A53', ... 'Manufacturer', 'ARM Compatible');

a53.LanguageImplementations = armv8;

target.add(a53)

When a target object is no longer required, you can use the function to remove the object from the internal database.

To remove only the target.Processor object, run:

Or:

target.remove('Processor', 'ARM Compatible-Cortex-A53');

To remove the target.Procesor object and its associatedtarget.LanguageImplementation object and suppress the command-line output, run:

target.remove(a53, ... 'IncludeAssociations', true, ... 'SuppressOutput',true);

Input Arguments

collapse all

Specify the target object that you want to remove.

Specify the class of the target object that you want to remove. For example:

• If the class is target.Processor, specify'Processor'.
• If the class is target.LanguageImplementation, specify'LanguageImplementation'.

Example: 'Processor'

Specify the unique identifier of the object that you want to remove, that is, theId property value of the object.

Name-Value Arguments

collapse all

Specify optional pairs of arguments asName1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: target.remove(_`myTargetObject`_, 'IncludeAssociations', true);

Remove associated objects from internal database:

• true –– Function removestargetObject and associated target objects from the internal database. If an associated object is referenced by another target object, the function does not remove the associated object. IftargetObject is not saved in the internal database, the function does not remove associated target objects from the internal database.
• false –– Function removes onlytargetObject from the internal database.

Example: target.remove(_`myTargetObject`_, 'IncludeAssociations', true);

Data Types: logical

Control command-line output of function:

• true –– Suppress command-line output from the function.
• false –– Provide information about the objects that the function removes from the internal database.

Example: target.remove(_`myTargetObject`_, 'SuppressOutput', true);

Data Types: logical

Version History

Introduced in R2019a