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

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

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