copyfile

Copiar un archivo o carpeta

Sintaxis

copyfile source

copyfile source destination

copyfile source destination f

copyfile(source,destination,CopyLinkBehavior=slbehavior)

status = copyfile(___)

[status,msg] = copyfile(___)

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

Descripción

copyfile source copia el archivo o carpeta source a la carpeta actual. Después de una operación copyfile correcta, la marca de tiempo del archivo nuevo es la misma que la marca de tiempo de source.

copyfile source destination copia source al archivo o carpeta destination.

• Si source es un archivo, destination puede ser un archivo o una carpeta.

• Si source es una carpeta, destination debe ser una carpeta.

• Si source es una carpeta o especifica varios archivos y destination no existe, copyfile intenta crear destination.

copyfile source destination f copia source a destination, incluso cuando destination no tiene permiso de escritura. El estado del atributo de lectura o escritura para destination no cambia.

copyfile(source,destination,CopyLinkBehavior=slbehavior) especifica si copiar un enlace simbólico o su objetivo. (desde R2024b)

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

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

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

Ejemplos

Copiar un archivo a otra carpeta

Copie myfile1.m de la carpeta actual a la subcarpeta myFolder.

mkdir myFolder
copyfile myfile1.m myFolder

Crear una copia de un archivo en la carpeta actual

Cree una copia de myfile1.m en la carpeta actual y asígnele el nombre myfile2.m.

copyfile myfile1.m myfile2.m

Copiar archivos y carpetas a una carpeta nueva

Copie archivos y subcarpetas con nombres que comiencen por my de la carpeta actual a la carpeta newFolder, donde newFolder aún no existe.

copyfile my* newFolder

Copiar un archivo a una carpeta de solo lectura

Copie 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

Copie el archivo myfile1.m y modifíquele el nombre. Un estado de 0 indica que la copia no se ha realizado correctamente.

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

status = logical
   0

Copie 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] = copyfile('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 se desea copiar

escalar de cadena | vector de caracteres

Archivo o carpeta que se desea copiar, especificado como un escalar de cadena o un vector de caracteres. Para copiar varios archivos o carpetas, utilice comodines (*). Cuando copia varios archivos o carpetas, copyfile copia solo los archivos y carpetas que pueden copiarse.

source puede ser una ruta absoluta o relativa cuando se copian archivos o carpetas locales. No obstante, para archivos y carpetas de una ubicación remota, debe especificar la ruta completa como localizador uniforme de recursos (URL). Las URL de Internet deben incluir el tipo de protocolo "http://" o "https://". 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, copyfile("myfile.m","newfolder").

destination — Destino del archivo o carpeta

escalar de cadena | vector de caracteres

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

Si destination es una ubicación local, puede especificar una ruta absoluta o relativa. Si source es una carpeta y la carpeta destination no existe, copyfile crea la carpeta. Si source es un archivo y la carpeta destination no existe, copyfile crea un archivo en su lugar utilizando el nombre de la carpeta, sin extensión. Para escribir un archivo en una carpeta de destino, la carpeta ya debe existir.

Si destination es una ubicación remota, debe especificar la ruta completa de una 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, copyfile("myfile.m","newfolder").

slbehavior — Comportamiento de enlace simbólico

"osdefault" (predeterminado) | "preserve" | "resolve"

Desde R2024b

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

• "osdefault": usa el comportamiento predeterminado del sistema de archivos.

• "preserve": copia 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": copia el objetivo del enlace simbólico.

Argumentos de salida

status — Estado de la copia

0 | 1

Estado de la copia, que indica 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, ''.

Limitaciones

• MATLAB^® no admite URL de Internet que requieran autenticación.

• MATLAB Online™ admite URL de Internet asociadas a archivos y carpetas Microsoft^® OneDrive™, mientras que la versión instalada de MATLAB admite solo archivos OneDrive locales.

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 copyfile 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 CopyFileExA de las plataformas de Windows o a las funciones read y write 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: Leer datos a través de HTTP y HTTPS con funciones de operaciones de archivos

Puede leer datos de fuentes online primarias realizando operaciones de lectura de archivos a través de una URL de Internet.

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

Puede copiar archivos y carpetas usando enlaces simbólicos. Cuando especifica un enlace simbólico como origen, puede controlar si se copia el propio enlace simbólico o si se copia 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.

R2020a: Los enlaces simbólicos se tratan de forma consistente en plataformas y sistemas de archivos

Los enlaces simbólicos (o symlinks) son objetos del sistema de archivos que dirigen a archivos o carpetas objetivo. A partir de la versión R2020a, el comportamiento de la función copyfile cambia cuando se opera con archivos o carpetas de enlaces simbólicos.

• El resultado de la copia es independiente de la plataforma: copyfile ahora trata los enlaces simbólicos de distintos sistemas operativos de la misma forma. Por ejemplo, considere una estructura de carpetas con un archivo myFile.m y un enlace simbólico que dirige a myFile.m, especificada como symlinkToMyFile.

  myFile.m
  symlinkToMyFile
  

  A partir de la versión R2020a, copyfile('symlinkToMyFile','newFile') copia el objetivo del enlace simbólico (es decir, myFile.m) al destino. En versiones previas, en Linux^®, copyfile copia el enlace simbólico en su lugar.

  Plataforma	newFile (a partir de la versión R2020a)	newFile (versión R2019b y anteriores)
  Linux	myFile.m	symlinkToMyFile
  Mac	myFile.m	myFile.m
  Windows	myFile.m	myFile.m

• copyfile copia solo el contenido de la carpeta de origen: Cuando se copia una carpeta no vacía a una carpeta de enlaces simbólicos, copyfile ahora copia el contenido de la carpeta de origen (es decir, los archivos y carpetas dentro de la carpeta de origen) en lugar de la carpeta de origen completa. De forma similar, cuando se copia una carpeta de enlaces simbólicos a una carpeta de destino, solo se copia el contenido de la carpeta de enlaces simbólicos.

  Por ejemplo, considere una estructura de carpetas en Linux que consista en una carpeta myFolder no vacía y un enlace simbólico a esa carpeta denominada symlinkToMyFolder. Esta tabla muestra la estructura de carpetas después de ejecutar copyfile('myFolder','simlinkToMyFolder') en distintas versiones de MATLAB.

  Estructura de carpetas antes de copiar	Estructura de carpetas después de copiar (a partir de la versión R2020a)	Estructura de carpetas después de copiar (R2019b y anteriores)
  myFolder myFile.m symlinkToMyFolder	myFolder myFile.m symlinkToMyFolder myFile.m	myFolder myFile.m symlinkToMyFolder myFolder myFile.m

Consulte también

Funciones

• cd | delete | dir | mkdir | movefile | rmdir

Temas

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