MLStartDir

Specify MATLAB current working folder after startup

Syntax

= MLStartDir(path)
MLStartDir path
out = MLStartDir(path)


Description

= MLStartDir(path) sets the MATLAB^® working folder after startup. Use this syntax when working directly in a worksheet.

MLStartDir path sets the MATLAB working folder after startup. Use this syntax in a VBA macro.

out = MLStartDir(path) lets you catch errors when executing MLStartDir in a VBA macro. If MLStartDir fails, then out is a string containing error code. Otherwise, out is 0.

Input Arguments

path	Path to the new MATLAB working folder after startup.

Output Arguments

out	Execution status that contains 0 if the command succeeded. Otherwise, out contains a string with an error code.

Examples

Specify MATLAB Working Folder

Set the MATLAB working folder to d:\work after start up in a worksheet cell.

=MLStartDir("d:\work")

Specify MATLAB Working Folder That Includes Spaces

If your folder path includes a space, embed the path in single quotation marks within double quotation marks.

Set the MATLAB working folder to d:\my work in a VBA macro.

MLStartDir "'d:\my work'"

Specify MATLAB Working Folder with Execution Status

Set the MATLAB working folder to d:\work after start up in a VBA macro. Return the execution status out.

out = MLStartDir("d:\work")

Tips

• This function does not work like the standard Microsoft^® Windows^® Start In setting, because it does not automatically run startup.m or matlabrc.m in the specified folder.

• The working folder changes only if you run MATLAB after you run this function. Running this function while MATLAB is running does not change the working folder for the current session. In this case, MATLAB uses the specified folder as the working folder when it is restarted.

• To work with VBA code in Excel^® with Spreadsheet Link™, you must enable Spreadsheet Link as a reference in the Microsoft Visual Basic^® Editor. For details, see Installation.