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