File Exchange

image thumbnail

CATSTRUCT

version 1.3.0.0 (4.95 KB) by Jos (10584)
Concatenate/merge structures (v4.1, feb 2015).

29.7K Downloads

Updated 04 Feb 2015

View License

Editor's Note: This file was selected as MATLAB Central Pick of the Week

CATSTRUCT Concatenate or merge structures with different fieldnames
X = CATSTRUCT(S1,S2,S3,...) merges the structures S1, S2, S3 ... into one new structure X. X contains all fields present in the various
structures. An example:

A.name = 'Me' ;
B.income = 99999 ;
X = catstruct(A,B)
% -> X.name = 'Me' ;
% X.income = 99999 ;

If a fieldname is not unique among structures (i.e., a fieldname is present in more than one structure), only the value from the last structure with this field is used. In this case, the fields are alphabetically sorted. A warning is issued as well. An axample:

S1.name = 'Me' ;
S2.age = 20 ; S3.age = 30 ; S4.age = 40 ;
S5.honest = false ;
Y = catstruct(S1,S2,S3,S4,S5) % use value from S4

The inputs can be array of structures. All structures should have the same size. An example:

C(1).bb = 1 ; C(2).bb = 2 ;
D(1).aa = 3 ; D(2).aa = 4 ;
CD = catstruct(C,D) % CD is a 1x2 structure array with fields bb and aa

The last input can be the string 'sorted'. In this case,
CATSTRUCT(S1,S2, ..., 'sorted') will sort the fieldnames alphabetically. To sort the fieldnames of a structure A, you could use CATSTRUCT(A,'sorted') but I recommend ORDERFIELDS for doing that.

When there is nothing to concatenate, the result will be an empty struct (0x0 struct array with no fields).

NOTE
To concatenate similar arrays of structs, you can use simple concatenation:
A = dir('*.mat') ; B = dir('*.m') ; C = [A ; B] ;
Latest version: 4.0 (dec 2013)

Cite As

Jos (10584) (2021). CATSTRUCT (https://www.mathworks.com/matlabcentral/fileexchange/7842-catstruct), MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2014a
Compatible with any release
Platform Compatibility
Windows macOS Linux
Acknowledgements

Inspired: Lynx MATLAB Toolbox, Structable

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!