- publishing free software manuals
GNU Octave Manual Version 3
by John W. Eaton, David Bateman, Søren Hauberg
Paperback (6"x9"), 568 pages
ISBN 095461206X
RRP £24.95 ($39.95)

Get a printed copy>>>

8.6 Assignment Expressions

An assignment is an expression that stores a new value into a variable. For example, the following expression assigns the value 1 to the variable z:

z = 1

After this expression is executed, the variable z has the value 1. Whatever old value z had before the assignment is forgotten. The ‘=’ sign is called an assignment operator.

Assignments can store string values also. For example, the following expression would store the value "this food is good" in the variable message:

thing = "food"
predicate = "good"
message = [ "this " , thing , " is " , predicate ]

(This also illustrates concatenation of strings.)

Most operators (addition, concatenation, and so on) have no effect except to compute a value. If you ignore the value, you might as well not use the operator. An assignment operator is different. It does produce a value, but even if you ignore the value, the assignment still makes itself felt through the alteration of the variable. We call this a side effect.

The left-hand operand of an assignment need not be a variable (see section 7 Variables). It can also be an element of a matrix (see section 8.1 Index Expressions) or a list of return values (see section 8.2 Calling Functions). These are all called lvalues, which means they can appear on the left-hand side of an assignment operator. The right-hand operand may be any expression. It produces the new value which the assignment stores in the specified variable, matrix element, or list of return values.

It is important to note that variables do not have permanent types. The type of a variable is simply the type of whatever value it happens to hold at the moment. In the following program fragment, the variable foo has a numeric value at first, and a string value later on:

octave:13> foo = 1
foo = 1
octave:13> foo = "bar"
foo = bar

When the second assignment gives foo a string value, the fact that it previously had a numeric value is forgotten.

Assignment of a scalar to an indexed matrix sets all of the elements that are referenced by the indices to the scalar value. For example, if a is a matrix with at least two columns,

a(:, 2) = 5

sets all the elements in the second column of a to 5.

Assigning an empty matrix ‘[]’ works in most cases to allow you to delete rows or columns of matrices and vectors. See section 4.1.1 Empty Matrices. For example, given a 4 by 5 matrix A, the assignment

A (3, :) = []

deletes the third row of A, and the assignment

A (:, 1:2:5) = []

deletes the first, third, and fifth columns.

An assignment is an expression, so it has a value. Thus, z = 1 as an expression has the value 1. One consequence of this is that you can write multiple assignments together:

x = y = z = 0

stores the value 0 in all three variables. It does this because the value of z = 0, which is 0, is stored into y, and then the value of y = z = 0, which is 0, is stored into x.

This is also true of assignments to lists of values, so the following is a valid expression

[a, b, c] = [u, s, v] = svd (a)

that is exactly equivalent to

[u, s, v] = svd (a)
a = u
b = s
c = v

In expressions like this, the number of values in each part of the expression need not match. For example, the expression

[a, b] = [u, s, v] = svd (a)

is equivalent to

[u, s, v] = svd (a)
a = u
b = s

The number of values on the left side of the expression can, however, not exceed the number of values on the right side. For example, the following will produce an error.

[a, b, c, d] = [u, s, v] = svd (a)
-| error: element number 4 undefined in return list
-| error: evaluating assignment expression near line 8, column 15

A very common programming pattern is to increment an existing variable with a given value, like this

a = a + 2;

This can be written in a clearer and more condensed form using the += operator

a += 2;

Similar operators also exist for subtraction (-=), multiplication (*=), and division (/=). An expression of the form

expr1 op= expr2

is evaluated as

expr1 = (expr1) op (expr2)

where op can be either +, -, *, or /. So, the expression

a *= b+1

is evaluated as

a = a * (b+1)

and not

a = a * b + 1

You can use an assignment anywhere an expression is called for. For example, it is valid to write x != (y = 1) to set y to 1 and then test whether x equals 1. But this style tends to make programs hard to read. Except in a one-shot program, you should rewrite it to get rid of such nesting of assignments. This is never very hard.

Built-in Function: subsasgn (val, idx, rhs)
Perform the subscripted assignment operation according to the subscript specified by idx.

The subscript idx is expected to be a structure array with fields ‘type’ and ‘subs’. Valid values for ‘type’ are ‘"()"’, ‘"{}"’, and ‘"."’. The ‘subs’ field may be either ‘":"’ or a cell array of index values.

The following example shows how to set the two first columns of a 3-by-3 matrix to zero.

val = magic(3);
idx.type = "()";
idx.subs = {":", 1:2};
subsasgn (val, idx, 0)
     => [ 0   0   6
          0   0   7
          0   0   2 ]

Note that this is the same as writing val(:,1:2) = 0.

See also subsref, substruct

ISBN 095461206XGNU Octave Manual Version 3See the print edition