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)

: 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)

: 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 (см. Перебор элементов структуры).