movefile

Mover o modificar el nombre de un archivo o carpeta

Sintaxis

movefile source

movefile source destination

movefile source destination f

movefile(source,destination,MoveLinkBehavior=slbehavior)

status = movefile(___)

[status,msg] = movefile(___)

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

Descripción

movefile source mueve el archivo o carpeta source a la carpeta actual. movefile no conserva el atributo de archivo de source.

movefile source destination mueve source al archivo o carpeta destination. Si source y destination están en la misma ubicación, movefile modifica el nombre de source a destination. Para modificar el nombre de un archivo o carpeta al moverlo, haga que destination tenga un nombre diferente de source y especifique solo un archivo o carpeta para source.

Si source es una carpeta, destination debe ser una carpeta. Si source es una carpeta o es capaz de especificar varios archivos y destination no existe, movefile crea destination.

movefile source destination f realiza el movimiento, incluso cuando destination no tiene permiso de escritura. El estado del atributo de lectura o escritura para destination no cambia. Esta sintaxis sobrescribe archivos de solo lectura.

movefile(source,destination,MoveLinkBehavior=slbehavior) especifica si mover un enlace simbólico o su objetivo. (desde R2024b)

status = movefile(___) mueve el archivo o carpeta especificado y devuelve un estado de 1 si la operación se realiza correctamente. De lo contrario, movefile devuelve 0. Puede utilizar esta sintaxis con cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

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

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

Ejemplos

Mover archivos a la carpeta actual

Mueva archivos y carpetas a la carpeta actual omitiendo la entrada de destino.

Cree dos carpetas: la primera, myfiles, que contiene el archivo myfile1.m, y la segunda, myotherfiles, que contiene el archivo myfile2.m.

mkdir myfiles
movefile myfile1.m myfiles
mkdir myotherfiles
movefile myfile2.m myotherfiles

Mueva myfile1.m a la carpeta actual. Dado que no se especifica un destino, MATLAB® asume que el destino es la carpeta actual.

movefile myfiles/myfile1.m

Establezca la carpeta actual en myfiles. Mueva myotherfiles y su contenido a la carpeta actual.

cd myfiles
movefile ../myotherfiles

Mover archivos y carpetas a una carpeta nueva

Mueva archivos y subcarpetas con nombres que comiencen por my de la carpeta actual a la carpeta newFolder, donde newFolder no exista previamente.

movefile my* newFolder

Modificar el nombre de una carpeta

Cree la carpeta myoldfolder y, después, modifique el nombre a mynewfolder.

mkdir myoldfolder
movefile myoldfolder mynewfolder

Mover un archivo a una carpeta de solo lectura

Mueva el archivo myfile1.m de la carpeta actual a la carpeta de solo lectura restricted.

Cree la carpeta de solo lectura restricted.

mkdir restricted
fileattrib restricted -w

Mueva el archivo myfile1.m. Un estado de 0 indica que la copia no se ha realizado correctamente.

status = movefile('myfile1.m','restricted');
status

status = logical
   0

Mueva el archivo myfile1.m usando la opción 'f' para anular el estado de solo lectura de la carpeta de destino. Un estado de 1 y message y messageID vacíos confirman que la copia se ha realizado correctamente.

[status,message,messageId] = movefile('myfile1.m','restricted','f');
status

status = logical
   1

message

message =

  0×0 empty char array

messageId

messageId =

  0×0 empty char array

Argumentos de entrada

source — Archivo o carpeta que desea mover

vector de caracteres | escalar de cadena

Archivo o carpeta que desea mover, especificado como vector de caracteres o escalar de cadena. Para mover varios archivos o carpetas, utilice comodines (*). Cuando mueva varios archivos o carpetas, movefile mueve solo los archivos y carpetas que pueden moverse.

source puede ser una ruta absoluta o relativa cuando se mueven archivos o carpetas locales. No obstante, para mover archivos y carpetas de una ubicación remota, source debe contener una ruta completa especificada como localizador uniforme de recursos (URL). Para obtener más información, consulte Trabajar con datos remotos.

Nota

Si source es una cadena, encierre todas las entradas entre paréntesis. Por ejemplo, movefile("myfile.m","newfolder").

destination — Destino del archivo o carpeta

vector de caracteres | escalar de cadena

Destino del archivo o carpeta, especificado como vector de caracteres o escalar de cadena. destination no puede incluir comodines (*).

Si destination es local, se puede especificar como ruta absoluta o relativa. Si destination es remota, debe contener una ruta completa especificada como URL. Para obtener más información, consulte Trabajar con datos remotos.

Nota

Si destination es una cadena, encierre todas las entradas entre paréntesis. Por ejemplo, movefile("myfile.m","newfolder").

slbehavior — Comportamiento de enlace simbólico

"preserve" (predeterminado) | "resolve"

Desde R2024b

Comportamiento de enlace simbólico, especificado como uno de estos valores:

• "preserve": mueve el enlace simbólico y lo mantiene como enlace simbólico en el destino. El objetivo del enlace simbólico sigue siendo el mismo.

• "resolve": mueve el objetivo del enlace simbólico.

Argumentos de salida

status — Estado del movimiento

0 | 1

Estado del movimiento, indicando si el intento de mover el archivo o carpeta tiene éxito, devuelto como 0 o 1. Si el intento tiene éxito, 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

• Esta función es compatible con archivos de acceso directo de Microsoft^® Windows^® (.lnk).

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• La función movefile puede mover archivos únicamente a un directorio vacío, no a uno que contenga archivos.

• La función movefile no es compatible con operaciones con comodines o URL como entrada.

• El código generado desde MATLAB^® puede comportarse de forma diferente a su ejecución dentro de MATLAB.

  En esos casos, la gestión del archivo en el código generado es similar a la función MoveFileExA de las plataformas de Windows o a la función rename de sistemas UNIX^® en el lenguaje C.

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

Historial de versiones

Introducido antes de R2006a

R2024b: Utilizar enlaces simbólicos para manipular archivos y carpetas

Puede mover archivos y carpetas usando enlaces simbólicos. Cuando especifica un enlace simbólico como origen, puede controlar si se mueve el propio enlace simbólico o si se mueve su objetivo.

R2020a: La expresión de comodín *.* en las plataformas UNIX solo coincide con archivos que tienen una extensión

A partir de la versión R2020a, en plataformas UNIX la expresión de comodín *.* ya no coincide con carpetas o archivos sin extensión. En versiones anteriores, la expresión coincide con carpetas o archivos independientemente de la extensión, incluidos los archivos sin extensión. Este cambio de comportamiento no se aplica a las plataformas Microsoft Windows.

Consulte también

Funciones

• cd | delete | dir | mkdir | copyfile | rmdir

Temas

• Administrar archivos y carpetas
• Especificar nombres de archivo
• Trabajar con datos remotos