Documentation

This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the page.

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 to oldFolder, and then changes the current folder to newFolder.

cd displays the current folder.

Input Arguments

newFolder

The folder to which you want to change the current folder, specified as a character vector. Valid values can be any one of the following:

  • A full or relative path.

  • ../, which indicates one level up from the current folder.

  • Multiples 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

The current folder that was in place when you issued the cd command, specified as a character vector.

Definitions

The current folder is a reference location that MATLAB® uses to find files. This folder is sometimes referred to as the current directory, current working folder, or present working directory.

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

collapse all

Tips

  • When using the command syntax (cd newfolder), if newFolder contains spaces, enclose it 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.

See Also

| | | |

Introduced before R2006a

Was this topic helpful?