cd — Query or change the current working folder.
cd returns the current folder or changes it and returns the previous folder.
Syntax
folder = cd
previous = cd(folder)Inputs
folder- Type
StringScalar- Required
- Yes
- Description
- Target folder as a character vector or string scalar.
Returns
folder- Type
StringScalar- Description
- Current folder for query form or previous folder for mutation form, as a character row vector.
Errors
RunMat:cd:TooManyInputs- When
- More than one input is provided.
- Message
cd: too many input arguments
RunMat:cd:InvalidFolder- When
- The folder is not a character row vector or string scalar.
- Message
cd: folder name must be a character vector or string scalar
RunMat:cd:EmptyFolder- When
- The folder text is empty.
- Message
cd: folder name must not be empty
Query or change the working folder
cd with no input returns the current working folder as a character row vector. cd(folder) changes the working folder and returns the previous folder, which can be passed back to cd when the work is complete.
The folder may be a character row vector or string scalar. Relative paths are resolved from the current folder. ~ and ~/... expand from the user's home folder when that environment value is available.
Runtime environment
Native execution updates the process working folder. Browser and embedded execution update the current folder maintained by the active virtual filesystem provider. Later relative file and source lookups observe the change.
Folder text is host data. cd does not accept accelerator-resident numeric buffers, launch a device kernel, or participate in fusion.
Examples
Read the current folder
current = cd;
assert(ischar(current));
assert(size(current, 1) == 1);Work in a project subfolder and restore the original folder
project_root = pwd;
mkdir('data');
mkdir(fullfile('data', 'logs'));
old = cd(fullfile('data', 'logs'));
assert(strcmp(old, project_root));
cd(old);
assert(strcmp(pwd, project_root));Navigate to the parent folder
start_dir = pwd;
old = cd('..');
assert(strcmp(old, start_dir));
cd(old);
assert(strcmp(pwd, start_dir));Use command syntax
project_root = pwd;
mkdir('scratch');
cd scratch
cd ..
assert(strcmp(pwd, project_root));Change to the home folder
start_dir = pwd;
old = cd('~');
assert(strcmp(old, start_dir));
cd(old);Capture and restore the previous folder
start_dir = pwd;
mkdir('results');
old = cd('results');
assert(strcmp(old, start_dir));
cd(old);
assert(strcmp(pwd, start_dir));Handle a missing folder
caught = false;
try
cd('missing-folder');
catch err
caught = true;
assert(~isempty(err.message));
end
assert(caught);Using cd with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how cd changes the result.
Run a small cd example, explain the result, then change one input and compare the output.
FAQ
Does cd return the new folder or the previous folder?⌄
With an input, it returns the previous folder. Without an input, it returns the current folder.
Can cd accept accelerator-resident values?⌄
No. Folder arguments are character row vectors or string scalars, both of which are host values.
Is tilde expansion supported?⌄
Yes. ~ and paths beginning with ~/ or ~\ use the current user's home folder when it can be resolved.
How are relative paths resolved?⌄
They are resolved from the current folder maintained by the active filesystem environment.
What happens if the target does not exist?⌄
RunMat raises a structured error containing the requested folder and the underlying filesystem detail.
Can folder names contain spaces?⌄
Yes. Pass the complete name as a string scalar or character row vector.
Related Io functions
Repl Fs
addpath · copyfile · delete · dir · exist · fileattrib · fileparts · filesep · fullfile · genpath · getenv · getpref · isenv · isfile · isfolder · ispref · ls · matlabroot · memmapfile · memmapfile.subsasgn · memmapfile.subsref · mkdir · movefile · open · opentoline · path · pathsep · pcode · pwd · readstruct · rehash · restoredefaultpath · rmdir · rmpath · run · savepath · setenv · setpref · system · tempdir · tempname · uigetdir · uigetfile · uiputfile · unsetenv · userpath · what · winqueryreg · xmlread · xmlwrite
Tabular
arrayDatastore · csvread · csvwrite · detectImportOptions · dlmread · dlmwrite · fileDatastore · getvaropts · parquetDatastore · parquetinfo · parquetread · readcell · readmatrix · readtable · readtimetable · setvaropts · setvartype · spreadsheetImportOptions · writecell · writematrix · writetable · writetimetable · xlsread · xlswrite
Data
commit · data.copy · data.create · data.delete · data.exists · data.export · data.import · data.inspect · data.list · data.move · data.open · DataArray.chunk_shape · DataArray.codec · DataArray.dtype · DataArray.fill · DataArray.name · DataArray.rank · DataArray.read · DataArray.resize · DataArray.shape · DataArray.write · Dataset.array · Dataset.arrays · Dataset.attrs · Dataset.begin · Dataset.get_attr · Dataset.has_array · Dataset.id · Dataset.path · Dataset.refresh · Dataset.set_attr · Dataset.set_attrs · Dataset.snapshot · Dataset.version · DataTransaction.abort · DataTransaction.commit · DataTransaction.create_array · DataTransaction.delete_array · DataTransaction.fill · DataTransaction.id · DataTransaction.resize · DataTransaction.set_attr · DataTransaction.set_attrs · DataTransaction.status · DataTransaction.write
Filetext
fclose · feof · fgetl · fgets · fileread · filewrite · fopen · fprintf · fread · frewind · fwrite · readlines · writelines
Import
Json
Source you can read
Every RunMat function's source is public. Read exactly how cd is executed, line by line, in Rust.
- View the source for cd in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.