6.1.1 Основное использование и примеры

Вот несколько примеров использования структур данных в Octave.

Элементы структур могут иметь значения любого типа. Например, три выражения

x.a = 1;
x.b = [1, 2; 3, 4];
x.c = "string";

создают структуру с тремя элементами. Символ «.» отделяет имя структуры (в приведённом выше примере x) от имени поля и указывает Octave, что эта переменная является структурой. Чтобы вывести значение структуры, можно ввести её имя, как и для любой другой переменной:

x
     ⇒ x =

         scalar structure containing the fields:

           a =  1
           b =

              1   2
              3   4

           c = string

Обратите внимание, что Octave может вывести элементы в любом порядке.

Структуры можно копировать так же, как и любые другие переменные:

y = x
     ⇒ y =

         scalar structure containing the fields:

           a =  1
           b =

              1   2
              3   4

           c = string

Поскольку структуры сами являются значениями, элементы структур также могут ссылаться на другие структуры. Следующий оператор добавляет поле d в структуру x. Значение поля d само является структурой данных, содержащей единственное поле a со значением 3.

x.d.a = 3;
x.d
     ⇒ ans =

         scalar structure containing the fields:

           a =  3

x
     ⇒ x =

         scalar structure containing the fields:

           a =  1
           b =

              1   2
              3   4

           c = string
           d =

             scalar structure containing the fields:

               a =  3

Обратите внимание, что при выводе значения структуры, содержащей другие структуры, Octave отображает лишь несколько уровней вложенности. Например:

a.b.c.d.e = 1;
a
     ⇒ a =

         scalar structure containing the fields:

           b =

             scalar structure containing the fields:

               c =

                 scalar structure containing the fields:

                   d: 1x1 scalar struct

Это предотвращает появление длинного и запутанного вывода для больших глубоко вложенных структур. Число уровней вложенности, выводимых для структур, можно задать с помощью функции struct_levels_to_print, а функцию print_struct_array_contents можно использовать, чтобы включить вывод содержимого массивов структур.

: val = struct_levels_to_print ()

: old_val = struct_levels_to_print (new_val)

: old_val = struct_levels_to_print (new_val, "local")

Запрос или изменение значения внутренней переменной, задающей число отображаемых уровней структуры.

При вызове из функции с параметром "local" значение переменной изменяется локально для этой функции и вызываемых ею подпрограмм. Исходное значение переменной восстанавливается при выходе из функции.

См. также: print_struct_array_contents.

: val = print_struct_array_contents ()

: old_val = print_struct_array_contents (new_val)

: old_val = print_struct_array_contents (new_val, "local")

Запрос или изменение значения внутренней переменной, определяющей, следует ли выводить содержимое массива структур.

Если значение истинно, выводятся значения элементов массива структур. Эта переменная не влияет на скалярные структуры, элементы которых выводятся всегда. Однако в обоих случаях вывод ограничивается числом уровней, заданным переменной struct_levels_to_print.

При вызове из функции с параметром "local" значение переменной изменяется локально для этой функции и вызываемых ею подпрограмм. Исходное значение переменной восстанавливается при выходе из функции.

См. также: struct_levels_to_print.

Функции могут возвращать структуры. Например, следующая функция разделяет действительную и мнимую части матрицы и сохраняет их в двух элементах одной и той же структурной переменной y.

function y = f (x)
  y.re = real (x);
  y.im = imag (x);
endfunction

При вызове с аргументом, содержащим комплексные значения, функция f возвращает структуру данных, содержащую действительную и мнимую части исходного аргумента функции.

f (rand (2) + rand (2) * I)
     ⇒ ans =

         scalar structure containing the fields:

           re =

              0.040239  0.242160
              0.238081  0.402523

           im =

              0.26475  0.14828
              0.18436  0.83669

Списки возвращаемых значений функции могут включать элементы структур, к которым можно обращаться по индексу, как и к любой другой переменной. Например:

[ x.u, x.s(2:3,2:3), x.v ] = svd ([1, 2; 3, 4]);
x

     ⇒ x =

         scalar structure containing the fields:

           u =

             -0.40455  -0.91451
             -0.91451   0.40455

           s =

              0.00000   0.00000   0.00000
              0.00000   5.46499   0.00000
              0.00000   0.00000   0.36597

           v =

             -0.57605   0.81742
             -0.81742  -0.57605

Также можно перебрать все элементы структуры в цикле, используя специальную форму оператора for (см. раздел Перебор элементов структуры).