File Exchange

image thumbnail

LOADFIXNAMES loads a mat file, fixing invalid names

version 1.3 (14 KB) by

Loads a mat file into the caller's workspace, fixing invalid variable and field names.

2 Downloads

Updated

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.

Comments and Ratings (2)

anthony gp

James Tursa

James Tursa (view profile)

NOTE: The supplied SAVEBADNAMES function only works for older versions of MATLAB (I think R2006a and earlier). After that TMW fixed the matPutVariable function so that it does not accept invalid names when writing to a mat file.

Updates

1.3

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

1.1

Added code to deal with duplicate variable names

Added capability to return a struct

MATLAB Release
MATLAB 7.3 (R2006b)
Tags Add Tags

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video