Make new folder
collapse all in page
Syntax
mkdir folderName
mkdir parentFolder folderName
status = mkdir(___)
[status,msg]= mkdir(___)
[status,msg,msgID]= mkdir(___)
Description
example
mkdir folderName createsthe folder folderName. If folderName exists, MATLAB® issuesa warning. If the operation is not successful, mkdir throwsan error to the Command Window.
example
mkdir parentFolder folderName creates folderName in parentFolder. If parentFolder does not exist, MATLAB attempts to create it.
example
status = mkdir(___) creates the specified folder and returns a status of 1 if the operation is successful or if the folder exists. Otherwise, mkdir returns 0 and does not throw a warning or error to the Command Window. You can use this syntax with any of the input argument combinations in the previous syntaxes.
example
[status,msg]= mkdir(___) also returns the message text for any warning or error that occurs.
example
[status,msg,msgID]= mkdir(___) additionally returns the message ID for any warning or error that occurs.
Examples
collapse all
Create Subfolder in Current Folder
Create a folder called newdir in the current folder.
mkdir newdirCreate Subfolder in Specified Parent Folder
Open Live Script
Create a folder called newfolder in the folder testdata. Use a relative path, where newFolder is at the same level as the current folder.
mkdir ../testdata newFolder
Create Folder That Already Exists
Open Live Script
Create the same folder twice, verifying the status of the operation after each try.
Create the folder newFolder. The operation succeeds, returning a status of 1 with no error or warning message.
[status, msg, msgID] = mkdir('newFolder')status = logical 1msg = 0x0 empty char arraymsgID = 0x0 empty char array
Create the folder newFolder again. The operation succeeds again, returning a status of 1. A warning message and message ID inform you that the folder already exists.
[status, msg, msgID] = mkdir('newFolder')status = logical 1msg = 'Directory already exists.'
msgID = 'MATLAB:MKDIR:DirectoryExists'
Input Arguments
collapse all
folderName — Folder name
character vector | string scalar
Folder name, specified as a character vector or string scalar. You can specify folderName as an absolute or relative path, unless a parent folder is specified. If you specify a parent folder, then folderName must be a path relative to the parent folder.
If folderName contains a path that includes one or more nonexistent folders, MATLAB attempts to create the nonexistent folder. For example, for the path myFolder\folder1\folder2\targetFolder, if folder1 does not exist, MATLAB creates folder1, creates folder2 within folder1, and creates targetFolder within folder2.
Data Types: char | string
parentFolder — Parent folder
character vector | string scalar
Parent folder for the new folder, specified as a character vector or string scalar. Specify parentFolder as an absolute or relative path. If parentFolder does not exist, MATLAB attempts to create it.
Data Types: char | string
Output Arguments
collapse all
status — Folder creation status
0 | 1
Folder creation status indicating whether the attempt to create the folder is successful, returned as 0 or 1. If the attempt to create the folder is successful or the folder already exists, then the value of status is 1. Otherwise, the value is 0.
Data Types: logical
msg — Error message
character vector
Error message, returned as a character vector. If an error or warning occurs, msg contains the message text of the error or warning. Otherwise, msg is empty, ''.
msgID — Error message identifier
character vector
Error message identifier, returned as a character vector. If an error or warning occurs, msgID contains the message identifier of the error or warning. Otherwise, msgID is empty, ''.
Tips
You can use
mkdirto create folders in remote locations. To write to a remote location,folderNameorparentNamemust contain the full path of the file specified as a uniform resource locator (URL) of the form:schema_name://path_to_file/folderNameor
schema_name://path_to_file/parentNameIt is also valid to use one or three "slash" (
/) characters betweenschema_nameandpath_to_file. For example:schema_name:/path_to_file/folderNameor
schema_name:///path_to_file/parentNameBased on your remote location,
schema_namecan be one of the values in this table.File System schema_nameAmazon S3™ s3Windows Azure® Blob Storage wasb,wasbsHDFS™ hdfsIf the file system being used does not support empty folders then attempting to use
mkdirwith that service will throw an error. For more information, see Work with Remote Data.
Extended Capabilities
Thread-Based Environment
Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.
This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.
Version History
Introduced before R2006a
expand all
R2022b: Use function in thread-based environments
This function supports thread-based environments.
See Also
cd | copyfile | dir | movefile | rmdir
Topics
- Manage Files and Folders
Commande MATLAB
Vous avez cliqué sur un lien qui correspond à cette commande MATLAB:
Pour exécuter la commande, saisissez-la dans la fenêtre de commande de MATLAB. Les navigateurs web ne supportent pas les commandes MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- Deutsch
- English
- Français
- United Kingdom (English)
Asia Pacific
- Australia (English)
- India (English)
- New Zealand (English)
- 中国
- 日本 (日本語)
- 한국 (한국어)
Contact your local office
