LOADFIXNAMES loads a mat file, fixing invalid names

Loads a mat file into the caller's workspace, fixing invalid variable and field names.
1.6K Downloads
Updated 1 Aug 2017

View License

Building:
LOADFIXNAMES is typically self building. That is, the first time you call it, the loadfixnames.m file recognizes that the mex routine needs to be compiled and then the compilation will happen automatically.
The usage is as follows (arguments in brackets [ ] are optional):

Syntax

loadfixnames(FILENAME [,names] [,verbose])
S = loadfixnames(FILENAME [,names] [,verbose])

FILENAME = The mat file to be loaded
names = string or cell array of strings (variable name(s) to load)
verbose = 1 or 0 (optional, causes name change log to be displayed)
S = struct returned instead of loading variables into workspace

Description

LOADFIXNAMES loads a mat file into the workspace, fixing invalid names. All invalid characters are replaced with an underscore. Also, if the first character is not a letter, an 'A' is added to the front. If the variable is a structure, fixes the field names also. In the case of field names, the name length is kept constant. So if a field name begins with a digit it will be replaced with 'A' - 'J' instead. If the field name begins with an invalid non-digit it will be replaced with 'A' - 'Z' or 'a' - 'z' (letters are cycled in an attempt to avoid name clashes).

Limitations: The current renaming scheme makes a mild attempt to avoid name clashes, but does not guarantee this.

See the companion function SAVEBADNAMES for a test function that will intentionally create a mat file with invalid names.

Building:

SAVEBADNAMES is typically self building. That is, the first time you call it, the savebadnames.m file recognizes that the mex routine needs to be compiled and then the compilation will happen automatically.

The usage is as follows (arguments in brackets [ ] are optional):

Syntax

savebadnames(FILENAME [,verbose])

FILENAME = The mat file to be saved
verbose = 1 or 0 (optional, causes name change log to be displayed)

Description

SAVEBADNAMES saves a mat file using intentionally invalid names.

Cite As

James Tursa (2024). LOADFIXNAMES loads a mat file, fixing invalid names (https://www.mathworks.com/matlabcentral/fileexchange/42274-loadfixnames-loads-a-mat-file-fixing-invalid-names), MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2006b
Compatible with any release
Platform Compatibility
Windows macOS Linux
Categories
Find more on Workspace Variables and MAT-Files in Help Center and MATLAB Answers
Tags Add Tags

Community Treasure Hunt

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

Start Hunting!
Version Published Release Notes
1.3.0.0

Fixed a bug in a name string copy. Also added smarter character replacement for upper ASCII characters.

1.1.0.0

Added code to deal with duplicate variable names

Added capability to return a struct

1.0.0.0