一些MATLAB®对象,如图形对象,实现基于集
和得到
功能。这些函数允许在单个函数调用中访问对象数组的多个属性。
您可以添加集
和得到
通过从这些类中派生一个类来实现类的功能:
matlab.mixin.SetGet
-当需要支持不区分大小写的部分属性名匹配金宝app时使用。派生自matlab.mixin.SetGet
不影响使用点符号引用属性所需的确切属性名。
matlab.mixin.SetGetExactNames
-当您希望仅支持区分大小写的完整属性名匹配时使金宝app用。
请注意
的集
和得到
本节中提到的方法不同于属性设置访问和属性获取访问方法。看到属性访问方法查阅有关物业使用方法的资料。
使用抽象类matlab.mixin.SetGet
或matlab.mixin.SetGetExactNames
作为一个超类:
classdefMyClass < matlab.mixin.SetGet…结束
因为matlab.mixin.SetGet
和matlab.mixin.SetGetExactNames
源自处理
类,你的子类也是处理
类。
的得到
方法使用对象句柄和属性名返回对象属性的值。例如,假设H
是一个对象的句柄:
v = get (H,'PropertyName
');
如果指定具有单个属性名的句柄数组,得到
以值的单元格数组形式返回每个对象的属性值:
简历=得到(H,'PropertyName
');
的简历
数组始终是列,而不管其形状如何H
.
如果指定单元格数组字符
向量属性名称和句柄数组,得到
返回属性值的单元格数组。单元格中的每一行都对应于句柄数组中的一个对象。单元格中的每一列对应一个属性名称。
道具= {'PropertyName1
','PropertyName2
'};简历= (H,道具);
得到
返回一个m × n单元格数组,其中m =长度(H)
和n =长度(道具)
.
如果指定句柄数组,但没有属性名,得到
返回类型为的数组结构体
其中,数组中的每个结构对应于中的一个对象H
.每个结构中的每个字段对应于类定义的属性H
.每个字段的值是相应属性的值。
SV = (H);
如果不指定输出变量,则H
必须是标量。
例如,请参见使用get和句柄数组.
的集
方法将指定的值赋给具有句柄的对象的指定属性H
.如果H
是一个句柄数组,MATLAB为数组中的每个对象赋值给属性H
.
集(H,'PropertyName
'PropertyValue)
可以将属性名称的单元格数组和属性值的单元格数组传递给集
:
道具= {'PropertyName1
','PropertyName2
'};瓦尔斯= {Property1Value, Property2Value};集(H,道具,瓦尔斯)
如果长度(H)
大于1,则属性值单元格数组(瓦尔斯
)可以为每个对象中的每个属性设置值。例如,假设长度(H)
是2(两个对象句柄)。你想在每个对象上分配两个属性值:
道具= {'PropertyName1
','PropertyName2
'};VAL={Property11Value,Property12Value;Property21Value,Property22Value};集合(H,props,VAL))
前面的陈述等价于下面的两个陈述:
集(H (1),'PropertyName1
'Property11Value,'PropertyName2
',Property12Value)集合(H(2),'PropertyName1
'Property21Value,'PropertyName2
'Property22Value)
如果指定标量句柄,但没有属性名,集
返回一个结构体
类中的每个属性都有一个字段H
.每个字段包含一个空单元格数组。
SV =组(h);
这个示例类定义了一个set/get接口,并演示了继承方法的行为:
classdef线型属性风格=“- - -”标志=“哦”结束属性(设置访问=受保护)单元=“点”结束方法函数obj =线型(s, m)如果nargin>0对象样式=s;对象标记=m;结束结束函数set.Style (obj, val)如果~ (strcmpi (val,“- - -”) | |...strcmpi (val,“——”) | |...strcmpi (val,“. .”))错误(“无效的行样式”)结束obj。年代tyle = val;结束函数集合标记(obj、val)如果~ isstrprop (val,“图形”)错误(“标记必须是可见字符”)结束目标标记=val;结束结束结束
创建一个类的实例并保存它的句柄:
h =线型(“——”,'*');
使用继承的属性查询任何对象属性的值得到
方法:
get (h,“标记”)
ans = ' * '
使用继承的属性设置任何属性的值集
方法:
集(h,“标记”,“问”)
MATLAB调用属性访问方法(集。年代tyle
或集。标记
在线型
类),当你使用集
和得到
方法。
集(h,“风格”,“”-”)
错误使用线型/组。风格(line 20) Invalid line style
有关属性访问方法的更多信息,请参见属性访问方法
返回一个结构体
使用包含对象属性及其当前值得到
:
h =线型(“——”,'*');SV =得到(h)
SV=带字段的结构:样式:'--'标记:'*'单位:'点'
返回一个结构体
包含属性的平民的
SetAccess
使用集
:
S =组(h)
S=带字段的结构:样式:{}标记:{}
的线型
类定义了单位
财产SetAccess =保护
.因此,S =组(h)
不创建字段为单位
在年代
.
集
不能返回具有非公共集访问权限的属性的可能值。
得到
使用句柄数组假设您创建了一个数组线型
对象:
H =[线型(“. .”,“z”),线型(“——”,“问”)]
H=1x2线型,具有以下特性:样式标记单位
当H
是一个句柄数组,得到
返回一个(长度(H)
-by-1)单元格属性值数组:
简历=得到(H,“风格”)
CV = 2×1 cell array {'..'}{“——”}
当H
是句柄数组,且不指定属性名称,得到
返回一个结构体
包含与属性名对应的名称的字段的数组。指定得到
为一个变量H
不是标量。
SV =得到(H)
SV = 2x1 struct数组与字段:风格标记单位
得到的值标记
属性中的第二个数组元素SV
数组的结构:
SV(2)。标记
ans =“问”
可以将句柄数组、属性名称单元格数组和属性值单元格数组传递给集
. 属性值单元格数组中的每个对象必须有一行属性值H
.每行必须为属性名数组中的每个属性有一个值:
H =[线型(“. .”,“z”),线型(“——”,“问”));集(H, {“风格”,“标记”},{“. .”,“哦”;“——”,“x”})
调用的结果集
是:
H (1)
ans = LineType属性:Style: '..'标记:'o'单位:'分
H (2)
ans = LineType带有属性:Style: '——' Marker: 'x' Units: 'points'
通过在子类中重新定义以下方法,自定义属性列表的显示方式:
派生的类matlab.mixin.SetGet
可以使用PartialMatchPriority
属性指定部分名称匹配的相对优先级。MATLAB在解析与多个属性名称匹配的不完整且不区分大小写的文本字符串时应用此属性。
继承的集
和得到
方法可以在不存在由不精确名称字符串导致的二义性时解析不精确的属性名称。当部分属性名由于匹配多个属性而不明确时,则PartialMatchPriority
属性值可以确定MATLAB匹配哪个属性。
默认优先级等于PartialMatchPriority = 1
。若要降低属性的相对优先级,请设置PartialMatchPriority
到2或更大的正整数。财产的优先级随着价值的降低而降低PartialMatchPriority
增加。
例如,在这个类中冗长
属性的名称匹配优先级高于版本
财产。
classdefMyClass < matlab.mixin.SetGet属性冗长结束属性(PartialMatchPriority = 2)版本号结束结束
调用集
方法带有可能存在歧义的不精确名称版本
设置冗长
因为它的相对优先级更高。没有设置PartialMatchPriority
属性时,歧义名称将导致错误。
一个= MyClass;集(,“版本”,10)disp(a)
MyClass with properties: verbose: 10 Version: []
相同的名称选择适用于得到
方法
v =得到(,“版本”)
v = 10
具有非匹配大小写的全名匹配优先于具有更高优先级属性的部分匹配。例如,这个类定义基线
属性的优先级为1(默认值)和a基地
属性的优先级为2(低于1)。
classdefMyClass < matlab.mixin.SetGet属性基线结束属性(PartialMatchPriority = 2) Base结束结束
调用集
方法的字符串基地
设置基地
财产。基线
具有更高的优先级,但大小写不正确的全名匹配优先。
一个= MyClass;集(,“基地”, 2) disp (a)
[] Base: -2
你可以使用PartialMatchPriority
属性,以避免在添加新属性时引入代码不兼容。例如,这个类启用集
和得到
方法来引用距离
属性的字符串说
因为DiscreteSamples
财产优先级较低。
classdef行星< matlab.mixin.SetGet% 1.0版本属性距离结束属性(PartialMatchPriority = 2结束结束
这个类的2.0版引入了一个名为不连续
.若要防止在现有代码中造成不明确的部分属性名,请使用PartialMatchPriority
设置…的优先级不连续
低于原有物业。
classdef行星< matlab.mixin.SetGet% 2.0版本属性直径;NumMoons = 0明显星等;DistanceFromSun;结束属性(PartialMatchPriority = 2)离散采样;结束属性(PartialMatchPriority = 3) Discontinuities = false;结束结束
的1.0版地球
类的调用集
方法并不含糊。
p =星球;集(p,“光盘”,真正的)
然而,随着不连续
财产,字符串阀瓣
变得模糊。通过给不连续
属性的优先级较低,字符串阀瓣
继续与DiscreteSamples
财产。
请注意
在编写可重用代码时,使用完整的、区分大小写的属性名可以避免歧义,防止与后续软件版本的不兼容,并生成更可读的代码。
集
|得到
|matlab.mixin.SetGet
|matlab.mixin.SetGetExactNames