subsasgn
添字を使用した代入
説明
A = subsasgn(A,S,B)A がオブジェクトである場合に構文 A(i) = B、A{i} = B、または A.i = B に対して呼び出されます。
MATLAB® では、インデックス付きの代入ステートメントを組み込み関数 subsasgn を使用して解釈します。
A(i) = Bは、Bの値を添字ベクトルiで指定されたAの要素に代入します。Bはiと同じ数の要素をもつか、スカラー値でなければなりません。A(i,j) = Bは、Bの値を添字ベクトルiおよびjで指定されたAの長方形の部分行列の要素に代入します。Bはlength(i)行length(j)列でなければなりません。A(i,:) = BまたはA(:,i) = Bのように添字として使用されるコロンは、列全体または行全体を示します。多次元配列の場合、
A(i,j,k,…) = Bは、BをAの指定された要素に代入します。Bはlength(i)×length(j)×length(k)... であるか、大きさが 1 の次元を追加または削除することでそのサイズにシフトできなければなりません。
ヒント
固定小数点の代入で A(:) = B などを使用して、いずれかの数値型の値を別の数値型にキャストできます。この添字を使用した代入ステートメントは、A の数値型を維持して B の値を A に代入します。添字を使用した代入は、整数データ型に対しても同様に機能します。
メモ
subsasgn は出力引数を指定して呼び出さなければなりません。subsasgn は、インデックス付け操作で使用されるオブジェクト (最初の引数) を変更しません。変更後のオブジェクトを取得するには、出力を代入する必要があります。
例
fi オブジェクト a と b について、以下には違いがあります。
a = b
および
a(:) = b.
最初のケースの a = b では、a が b に関連付けられた値、数値型、および fimath オブジェクトであると仮定して a を b に置き換えます。2 番目のケースの a(:) = b では、a の数値型を維持して b の値を a に代入します。これを使用して、いずれかの numerictype オブジェクトの値を別の numerictype オブジェクトにキャストできます。
たとえば、16 ビット数を 8 ビット数にキャストします。
a = fi(0, 1, 8, 7)
a =
0
DataTypeMode: Fixed-point: binary point scaling
Signedness: Signed
WordLength: 8
FractionLength: 7
b = fi(pi/4, 1, 16, 15)
b =
0.7854
DataTypeMode: Fixed-point: binary point scaling
Signedness: Signed
WordLength: 16
FractionLength: 15
a(:) = b
a =
0.7891
DataTypeMode: Fixed-point: binary point scaling
Signedness: Signed
WordLength: 8
FractionLength: 7
変数 acc を定義して 40 ビットの DSP アキュムレータをエミュレートします。この例の積と和は、構文 acc(1)=... を使用してアキュムレータに代入されます。値をアキュムレータに代入することは、値をレジスタに格納することに似ています。まず、ログ モードをオンにし、変数を定義します。この例では、n は入力データ x と出力データ y の点の数、t は時間を表します。残りの変数はすべて fi オブジェクトとして定義されています。入力データ x は、低周波数正弦波に追加される高周波数正弦波です。
fipref('LoggingMode', 'on'); n = 100; t = (0:n-1)/n; x = fi(sin(2*pi*t) + 0.2*cos(2*pi*50*t)); b = fi([.5 .5]); y = zeros(size(x),'like',x); acc = fi(0.0, true, 40, 30);
次のループは、b の係数を使用して入力 x のランニング平均を求めます。acc=... を使用した場合は acc のデータ型が上書きされて変更されるのに対し、ここでは acc を acc(1)=... に代入していることに注目してください。
for k = 2:n acc(1) = b(1)*x(k); acc(1) = acc + b(2)*x(k-1); y(k) = acc; end
サンプルを 1 つおきに平均化することで、上記のループは低周波数正弦波を通過させ、高周波数正弦波を減衰させます。
plot(t,x,'x-',t,y,'o-') legend('input data x','output data y')
ログ レポートに、ログ記録された最小値と最大値、および使用された変数の範囲が示されます。acc を上書きするのではなく代入しているため、これらのログは累積の最小値と最大値を反映したものになります。
logreport(x, y, b, acc)
minlog maxlog lowerbound upperbound noverflows nunderflows
x -1.200012 1.197998 -2 1.999939 0 0
y -0.9990234 0.9990234 -2 1.999939 0 0
b 0.5 0.5 -1 0.9999695 0 0
acc -0.9990234 0.9989929 -512 512 0 0
acc を表示して、そのデータ型が変わっていないことを確認します。
acc
acc =
-0.0941
DataTypeMode: Fixed-point: binary point scaling
Signedness: Signed
WordLength: 40
FractionLength: 30
fipref オブジェクトをリセットして既定値に戻します。
reset(fipref)
入力引数
出力引数
拡張機能
バージョン履歴
R2006a より前に導入
