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

remove

类: slreq.Requirement
命名空间: slreq

从需求集删除需求

全页展开

语法

count = remove(req)
count = remove(parentReq,'PropertyName1',PropertyValue1,...,'PropertyNameN',PropertyValueN)

说明

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

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

示例

注意

当您删除一个需求时，与被删除的 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
打开实时脚本

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

加载需求集并使用 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
打开实时脚本

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

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

加载需求集文件并使用 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

版本历史记录

在 R2018a 中推出

另请参阅

| |