Main Content

本页采用了机器翻译。点击此处可查看英文原文。

remove

类: slreq.Requirement
命名空间: slreq

从需求集删除需求

说明

count = remove(req) 删除需求 req 并返回已删除的需求数量。如果 req 有子需求,则也会被删除。

示例

count = remove(parentReq,'PropertyName1',PropertyValue1,...,'PropertyNameN',PropertyValueN) 删除与 PropertyNamePropertyValue 指定的属性匹配的 parentReq 子需求。该函数返回已删除的需求数量。父需求未删除。

注意

当您删除一个需求时,与被删除的 slreq.Requirement 对象相对应的变量仍保留在工作区中,但不再是有效的 slreq.Requirement 对象。

输入参数

全部展开

需求,指定为 slreq.Requirement 对象。

父级需求,指定为 slreq.Requirement 对象。

需求属性名称,指定为字符向量。请参阅 slreq.Requirement属性 部分中的有效属性名称。

示例: 'Type', 'Id', 'Keywords'

需求属性值,指定为字符向量、字符数组、datetime 值、标量、logical 或结构体数组。该值取决于指定的 propertyName。请参阅 slreq.Requirement属性 部分中的有效属性值。

示例: 'Functional', '1.1.1', 'Design'

输出参量

全部展开

已删除的需求总数,以 double 形式返回。

示例

全部展开

此示例显示如何查找和删除单个需求。

加载需求集文件。使用 ID 号在需求集中找到一个需求,然后将其删除。

rs = slreq.load('crs_req_func_spec.slreqx');
req = find(rs,'Type','Requirement','ID','#2');
count = remove(req)
count = 1

清理

清理命令。清除打开的需求集而不保存更改,并关闭打开的模型而不保存更改。

slreq.clear;
bdclose all;

此示例显示如何删除父需求及其子需求。

加载需求集并使用 ID 号查找父需求。通过检查其是否有子项来确认其为父项需求,然后删除该需求。当您删除父级需求时,子级需求也会被删除。

rs = slreq.load('crs_req_func_spec.slreqx');
parentReq1 = find(rs,'Type','Requirement','ID','#24');
childReqs1 = children(parentReq1)
childReqs1=1×12 Requirement array with properties:
    Type
    Id
    Summary
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedBy
    IndexEnabled
    IndexNumber
    SID
    FileRevision
    ModifiedOn
    Dirty
    Comments
    Index

count2 = remove(parentReq1)
count2 = 13

清理

清理命令。清除打开的需求集而不保存更改,并关闭打开的模型而不保存更改。

slreq.clear;
bdclose all;

此示例显示如何删除与属性类型匹配的子需求,以及如何自动删除具有匹配属性类型的所有需求。

删除与属性类型匹配的子需求

加载需求集文件并使用 ID 号查找父需求。

rs = slreq.load('crs_req_func_spec.slreqx');
parentReq = find(rs,'Type','Requirement','ID','#63');

通过检查该需求是否有子需求来确认该需求是否为父需求,并删除与该修订号匹配的子需求。

childReqs = children(parentReq)
childReqs=1×7 Requirement array with properties:
    Type
    Id
    Summary
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedBy
    IndexEnabled
    IndexNumber
    SID
    FileRevision
    ModifiedOn
    Dirty
    Comments
    Index

count1 = remove(parentReq,'FileRevision',54)
count1 = 4

删除与属性类型匹配的多个需求

通过查找需求集在修订版 18 中修改的所有需求来创建需求数组。

reqs = find(rs,'Type','Requirement','FileRevision',18);

初始化计数变量,然后循环遍历需求数组并删除所有需求。每次删除需求时增加计数变量,然后显示删除的需求总数。

count2 = 0;
for i = 1:numel(reqs)
    count2 = count2 + remove(reqs(i));
end
count2
count2 = 4

清理

清理命令。清除打开的需求集而不保存更改,并关闭打开的模型而不保存更改。

slreq.clear;
bdclose all;

版本历史记录

在 R2018a 中推出