mkdir

Crear una carpeta nueva

Sintaxis

mkdir folderName

mkdir parentFolder folderName

status = mkdir(___)

[status,msg] = mkdir(___)

[status,msg,msgID] = mkdir(___)

Descripción

mkdir folderName crea la carpeta folderName. Si folderName existe, MATLAB^® emite una advertencia. Si la operación no se realiza correctamente, mkdir genera un error en la ventana de comandos.

mkdir parentFolder folderName crea folderName en parentFolder. Si parentFolder no existe, MATLAB intenta crearla.

status = mkdir(___) crea la carpeta especificada y devuelve un estado de 1 si la operación se realiza correctamente o si la carpeta existe. De lo contrario, mkdir devuelve 0 y no genera una advertencia ni un error en la ventana de comandos. Puede utilizar esta sintaxis con cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

[status,msg] = mkdir(___) también devuelve el texto del mensaje para cualquier advertencia o error que se produzca.

[status,msg,msgID] = mkdir(___) también devuelve el ID del mensaje para cualquier advertencia o error que se produzca.

Ejemplos

Crear una subcarpeta en la carpeta actual

Cree una carpeta llamada newdir en la carpeta actual.

 mkdir newdir

Crear una subcarpeta en la carpeta principal especificada

Cree una carpeta llamada newfolder en la carpeta testdata. Utilice una ruta relativa donde newFolder esté en el mismo nivel que la carpeta actual.

mkdir ../testdata newFolder

Crear una carpeta que ya existe

Cree la misma carpeta dos veces, verificando el estado de la operación después de cada intento.

Cree la carpeta newFolder. La operación se realiza correctamente y devuelve un estado de 1 sin mensaje de error ni advertencia.

[status, msg, msgID] = mkdir('newFolder')

status = logical
   1

msg =

  0×0 empty char array


msgID =

  0×0 empty char array

Cree la carpeta newFolder de nuevo. La operación vuelve a realizarse correctamente y devuelve un estado de 1. Un mensaje de advertencia y el ID del mensaje le informan de que la carpeta ya existe.

[status, msg, msgID] = mkdir('newFolder')

status = logical
   1

msg = 
'Directory already exists.'

msgID = 
'MATLAB:MKDIR:DirectoryExists'

Argumentos de entrada

folderName — Nombre de carpeta

vector de caracteres | escalar de cadena

Nombre de carpeta, especificado como vector de caracteres o escalar de cadena. Puede especificar folderName como ruta absoluta o relativa, a menos que se especifique una carpeta principal. Si especifica una carpeta principal, folderName debe ser una ruta relativa a una carpeta principal.

Si folderName contiene una ruta con una o más carpetas que no existen, MATLAB intenta crear la carpeta que no existe. Por ejemplo, en el caso de la ruta myFolder\folder1\folder2\targetFolder, si folder1 no existe, MATLAB crea folder1, crea folder2 en folder1 y crea targetFolder en folder2.

Tipos de datos: char | string

parentFolder — carpeta principal

vector de caracteres | escalar de cadena

Carpeta principal de la nueva carpeta, especificada como vector de caracteres o escalar de cadena. Especifique parentFolder como ruta absoluta o relativa. Si parentFolder no existe, MATLAB intenta crearla.

Tipos de datos: char | string

Argumentos de salida

status — Estado de creación de la carpeta

0 | 1

Estado de creación de la carpeta que indica si el intento de crear la carpeta ha tenido éxito, devuelto como 0 o 1. Si el intento de crear la carpeta tiene éxito o si la carpeta ya existe, el valor de status es 1. De lo contrario, el valor es 0.

Tipos de datos: logical

msg — Mensaje de error

vector de caracteres

Mensaje de error, devuelto como vector de caracteres. Si se produce un error o una advertencia, msg contiene el texto del mensaje correspondiente. De lo contrario, msg está vacío, ''.

msgID — Identificador del mensaje de error

vector de caracteres

Identificador del mensaje de error, devuelto como vector de caracteres. Si se produce un error o una advertencia, msgID contiene el identificador del mensaje correspondiente. De lo contrario, msgID está vacío, ''.

Sugerencias

• Puede utilizar mkdir para crear carpetas en ubicaciones remotas: Para guardar archivos en una ubicación remota, folderName o parentName deben contener la ruta completa del archivo, especificada como un localizador uniforme de recursos (URL) con el formato:

  schema_name://path_to_file/folderName

  o

  schema_name://path_to_file/parentName

  También es válido usar una o tres barras inclinadas (/) entre schema_name y path_to_file. Por ejemplo:

  schema_name:/path_to_file/folderName

  o

  schema_name:///path_to_file/parentName

  Según la ubicación remota, schema_name puede ser uno de los valores de esta tabla.

  Sistema de archivos	schema_name
  Amazon S3™	s3
  Windows Azure® Blob Storage	wasb, wasbs
  HDFS™	hdfs

  Si el sistema de archivos que se usa no admite carpetas vacías, al intentar usar mkdir con ese servicio se generará un error. Para obtener más información, consulte Trabajar con datos remotos.

Capacidades ampliadas

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Historial de versiones

Introducido antes de R2006a

R2022b: Uso de la función en entornos basados en subprocesos

Esta función es compatible con entornos basados en subprocesos.

Consulte también

cd | copyfile | dir | movefile | rmdir

Temas

• Administrar archivos y carpetas