<< namedargs2cell Data structures rmfield >>

orderfields


Reorganize the fields of a structured array.


Syntax


S = orderfields(S1)
S = orderfields(S1, S2)
S = orderfields(S1, C)
S = orderfields(S1, P)
[S, Pout] = orderfields(...)

Input argument


S1

structure array: Input structure.

S2

structure array: Field order by structure.

C

cell array of character vectors or string array: Field order by name

P

numeric vector: Field order by number.

Output argument


S

structure array: Reordered structure.

Pout

numeric vector: Output field order.

Description


S = orderfields(S1) sorts the fields in S1 alphabetically by their names, considering uppercase letters before lowercase ones, and digits and underscores are also accounted for.

S = orderfields(S1,S2) returns a copy of S1 with its fields rearranged to match the order of fields in S2.Both S1 and S2 must share the same field names.

S = orderfields(S1, C) matches the order specified in the input array C. Each field name from S1 must appear once in C.

S = orderfields(S1, P) reorders fields based on the permutation vector P. P contains integers from 1 to n, where n is the number of fields in S1. This syntax is useful for maintaining consistent ordering across multiple structure arrays.

[S, Pout] = orderfields(...) also returns a permutation vector Pout, indicating the changes in field order. Pout consists of integers from 1 to n, reflecting the rearranged field positions. This syntax is compatible with any of the previously mentioned arguments.

orderfields function exclusively arranges the top-level fields and doesn't operate recursively.

Example


s = struct ("d", 4, "b", 2, "a", 1, "c", 3);
tA = orderfields (s)
t = struct ("d", {}, "c", {}, "b", {}, "a", {});
tB = orderfields (s, tA)

See also


struct, fieldnames, isfield.

History


Version Description
1.5.0 initial version

Author


Allan CORNET

<< namedargs2cell Data structures rmfield >>