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 (см. Проход по элементам структуры).