Accelerating the pace of engineering and science

Documentation Center

cd

Change current folder

Syntax

cd(newFolder) oldFolder = cd(newFolder) cd

Description

cd(newFolder) changes the current folder to newFolder.

oldFolder = cd(newFolder) returns the existing current folder as a string to oldFolder, and then changes the current folder to newFolder.

cd displays the current folder.

Input Arguments

newFolder

A string specifying the folder to which you want to change the current folder. Valid values can be any one of the following:

A full or relative path.
../, which indicates one level up from the current folder.
Multiple strings of ../, which indicates multiple levels up from the current folder.
./, which indicates a path relative to the current folder, although without the ./, cd assumes that the path is relative to the current folder.

Output Arguments

oldFolder

A string specifying the current folder that was in place when you issued the cd command.

Definitions

The current folder is a reference location that MATLAB^® uses to find files. See The Current Folder.

Examples

Use cd with the matlabroot function to change the current folder to the examples directory for the currently running version of MATLAB:

cd(fullfile(matlabroot, '/help/techdoc/matlab_env/examples'))

On a Microsoft^® Windows^® platform, specify the full path to change the current folder from any location to the examples directory for MATLAB Version 7.11 (R2010b), assuming that version is installed on your C: drive:

cd('C:/Program Files/MATLAB/R2010b/help/techdoc/matlab_env/examples')

% Change the current folder from
% C:/Program Files/MATLAB/R2010b/help/techdoc/matlab_env/examples to 
% C:/Program Files/MATLAB/R2010b/help/techdoc:

cd ../..

% Use a relative path to change the current folder from 
% C:/Program Files/MATLAB/R2010b/help/techdoc back to 
% C:/Program Files/MATLAB/R2010b/help/techdoc/matlab_env/examples:

cd matlab_env/examples

% Change the current folder from its current location to a new location, 
% but save its previous location. Later, change the current folder to the 
% previous location.

% This returns C:/Program Files/MATLAB/R2010b/help/techdoc/matlab_env/examples 
% to oldFolder, and then changes the current folder to C:/Program Files:

oldFolder = cd('C:/Program Files') 

% Display current folder:

pwd

% Change the current folder to the previous location:
cd(oldFolder)

pwd

On a UNIX^® platform, change the current folder to the examples directory for the currently running version of MATLAB, assuming it is installed in your home location:

cd('~/help/techdoc/matlab_env/examples')

More About

expand all

Tips

When using the command syntax (cd newfolder), if the newFolder string contains spaces, enclose the string in single quotation marks.
On UNIX platforms, use the ~ (tilde) character to represent the user home directory.
If you use cd within a local function, the folder change persists after program control returns from the function. That is, the scope of the folder change is global.