6.1.4 Обработка структур

Ниже приведены другие функции, которые могут обрабатывать поля структуры.

: numfields (s) ¶

Возвращает количество полей структуры s.

См. также: fieldnames.

: names = fieldnames (struct) ¶

: names = fieldnames (obj) ¶

: names = fieldnames (javaobj) ¶

: names = fieldnames ("javaclassname") ¶

Возвращает ячейковый массив строк с именами полей в указанном вводе.

Когда ввод — структура struct, names — это элементы структуры.

Когда ввод — объект Octave obj, names — это открытые свойства объекта.

Когда ввод — объект Java javaobj или строка, содержащая имя класса Java javaclassname, names — это открытые поля (данные члены) объекта или класса.

См. также: numfields, isfield, orderfields, struct, свойства.

: isfield (x, "name") ¶

: isfield (x, name) ¶

Возвращает true, если x — структура и содержит элемент с именем name.

Если name — ячейковый массив строк, возвращается логический массив той же размерности.

См. также: fieldnames.

: sout = setfield (s, field, val) ¶

: sout = setfield (s, sidx1, field1, fidx1, sidx2, field2, fidx2, …, val) ¶

Возвращает копию структуры s с полем field, установленным в значение val.

Например:

s = struct ();
s = setfield (s, "foo bar", 42);

Это эквивалентно

s.("foo bar") = 42;

Обратите внимание, что обычный синтаксис структуры s.foo bar = 42 здесь нельзя использовать, так как имя поля не является допустимым идентификатором Octave из-за пробела. Использование произвольных строк в качестве имён полей несовместимо с MATLAB, и это использование будет выдавать предупреждение, если идентификатор предупреждения Octave:language-extension включён. См. warning_ids.

Со второй формой вызова устанавливается поле массива структур. Ввод sidx выбирает элемент массива структур, field указывает имя поля выбранного элемента, а fidx выбирает элемент поля (в случае массива или ячейкового массива). Вводы sidx, field и fidx можно повторять для адресации элементов вложенных массивов структур. Индекс массива структуры и индекс элемента поля должны быть ячейковыми массивами, а имя поля — строкой.

Например:

s = struct ("baz", 42);
setfield (s, {1}, "foo", {1}, "bar", 54)
⇒
  ans =
    scalar structure containing the fields:
      baz =  42
      foo =
        scalar structure containing the fields:
          bar =  54

Пример начинается с обычной скалярной структуры, к которой добавляется вложенная скалярная структура. Во всех случаях, если индекс структуры sidx не указан, он по умолчанию равен 1 (скалярная структура). Таким образом, пример выше можно записать более кратко как setfield (s, "foo", "bar", 54)

Наконец, пример с вложенными массивами структур:

sa.foo = 1;
sa = setfield (sa, {2}, "bar", {3}, "baz", {1, 4}, 5);
sa(2).bar(3)
⇒
  ans =
    scalar structure containing the fields:
      baz =  0   0   0   5

Здесь sa — массив структур, поле которого в элементах 1 и 2, в свою очередь, является другим массивом структур, третий элемент которого — простая скалярная структура. У конечной скалярной структуры есть поле, содержащее матричное значение.

Обратите внимание, что тот же результат, что и в примере выше, можно получить, используя:

sa.foo = 1;
sa(2).bar(3).baz(1,4) = 5

См. также: getfield, rmfield, orderfields, isfield, fieldnames, isstruct, struct.

: val = getfield (s, field) ¶

: val = getfield (s, sidx1, field1, fidx1, …) ¶

Получить значение поля с именем field из структуры или вложенной структуры s.

Если s — массив структур, то sidx выбирает элемент массива структуры, field указывает имя поля выбранного элемента, а fidx выбирает элемент поля (в случае массива или ячейкового массива). Более подробное описание синтаксиса см. в setfield.

См. также: setfield, rmfield, orderfields, isfield, fieldnames, isstruct, struct.

: sout = rmfield (s, "f") ¶

: sout = rmfield (s, f) ¶

Возвращает копию структуры (массива) s с удалённым полем f.

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

См. также: orderfields, fieldnames, isfield.

: sout = orderfields (s1) ¶

: sout = orderfields (s1, s2) ¶

: sout = orderfields (s1, {cellstr}) ¶

: sout = orderfields (s1, p) ¶

: [sout, p] = orderfields (…) ¶

Возвращает копию s1 с полями, упорядоченными по алфавиту или согласно указаниям второго входа.

При одном входе — структуре s1 — поля упорядочиваются по алфавиту.

Если указана вторая структура s2, поля s1 упорядочиваются так же, как и в s2. Второй аргумент может также задавать порядок в ячейковом массиве строк cellstr. Второй аргумент может также быть вектором перестановки.

Необязательный второй выходной аргумент p — это вектор перестановки, который преобразует исходный порядок имён в новый порядок имён.

Примеры:

s = struct ("d", 4, "b", 2, "a", 1, "c", 3);
t1 = orderfields (s)
  ⇒ t1 =
       scalar structure containing the fields:
         a =  1
         b =  2
         c =  3
         d =  4

t = struct ("d", {}, "c", {}, "b", {}, "a", {});
t2 = orderfields (s, t)
  ⇒ t2 =
       scalar structure containing the fields:
         d =  4
         c =  3
         b =  2
         a =  1

t3 = orderfields (s, [3, 2, 4, 1])
  ⇒ t3 =
       scalar structure containing the fields:
         a =  1
         b =  2
         c =  3
         d =  4

[t4, p] = orderfields (s, {"d", "c", "b", "a"})
  ⇒ t4 =
       scalar structure containing the fields:
         d =  4
         c =  3
         b =  2
         a =  1
     p =
        1
        4
        2
        3

См. также: fieldnames, getfield, setfield, rmfield, isfield, isstruct, struct.

: substruct (type, subs, …) ¶

Создаёт структуру индексов для использования с subsref или subsasgn.

Например:

idx = substruct ("()", {3, ":"})
  ⇒ idx =
       scalar structure containing the fields:
         type = ()
         subs =
         {
           [1,1] =  3
           [1,2] = :
         }
x = [1, 2, 3;
     4, 5, 6;
     7, 8, 9];
subsref (x, idx)
  ⇒   7   8   9

См. также: subsref, subsasgn.