pwd — Return the current working folder.
pwd returns the active runtime environment's current working folder as a character row vector.
Syntax
folder = pwdReturns
folder- Type
StringScalar- Description
- Current working folder as a character row vector.
Errors
RunMat:pwd:TooManyInputs- When
- One or more input arguments are provided.
- Message
pwd: too many input arguments
RunMat:pwd:CurrentDirectoryUnavailable- When
- The current working directory cannot be resolved.
- Message
pwd: unable to determine current directory
RunMat:pwd:TooManyOutputs- When
- More than one output is requested.
- Message
pwd: too many output arguments
Working-folder query
pwd returns the current working folder as a character row vector. The path uses the active platform's native representation and separators.
A successful cd call changes the value returned by subsequent pwd calls. Reading the folder does not change workspace values, the search path, or the working folder itself.
Execution and placement
The runtime asks its filesystem environment for the current directory. Native hosts query the process environment; browser hosts query the virtual filesystem environment supplied to the WebAssembly runtime.
pwd is a host operation and does not invoke an accelerator provider, gather device values, or participate in fusion.
Examples
Read the current working folder
current = pwd;
assert(ischar(current));
assert(size(current, 1) == 1);
disp(current)Expected output:
The absolute path of the current working folder.Restore a folder after completing work
start_dir = pwd;
mkdir('results');
cd('results');
assert(strcmp(pwd, fullfile(start_dir, 'results')));
cd(start_dir);
assert(strcmp(pwd, start_dir));Use the previous folder returned by cd
start_dir = pwd;
previous = cd('..');
assert(strcmp(previous, start_dir));
cd(previous);
assert(strcmp(pwd, start_dir));Print the folder where a script starts
folder = pwd;
fprintf('Script started in %s\n', folder)Expected output:
Script started in <current folder>Write the working folder to a log
current = pwd;
fid = fopen('run.log', 'w');
fprintf(fid, 'Working folder: %s\n', current);
fclose(fid);
contents = fileread('run.log');
assert(contains(contents, current));Handle an unavailable working folder
try
location = pwd;
assert(ischar(location));
catch err
disp(err.message);
endExpected output:
Returns a path or reports why the host could not resolve it.Using pwd with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how pwd changes the result.
Run a small pwd example, explain the result, then change one input and compare the output.
FAQ
Why does pwd return a character vector instead of a string scalar?⌄
The compatible return type is a character row vector. Use string(pwd) when a string scalar is more convenient.
Does pwd reflect changes made with cd?⌄
Yes. Each call reads the current folder from the active runtime environment.
Can pwd fail?⌄
Yes. The host can report that the current directory is unavailable, for example after an external process removes it. RunMat returns a structured runtime error containing the host detail.
Does pwd normalize the path?⌄
RunMat returns the path supplied by the active filesystem environment. Platform-native separators and representation are preserved.
Does pwd affect GPU-resident values?⌄
No. It has no data inputs and performs no accelerator operation or transfer.
Related Io functions
Repl Fs
addpath · cd · 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 · 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 pwd is executed, line by line, in Rust.
- View the source for pwd 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.