exist

Comprobar la existencia de una variable, script, función, carpeta o clase

Sintaxis

exist name

exist name searchType

typeID = exist(___)

Descripción

exist name devuelve el tipo de name como un número. Esta lista describe el tipo asociado a cada valor:

• 0: name no existe o no se puede encontrar por otras razones. Por ejemplo, si name existe en una carpeta restringida a la que MATLAB^® no tiene acceso, exist devuelve 0.

• 1: name es una variable en el área de trabajo.

• 2: name es un archivo con la extensión .m, .mlx o .mlapp, o name es el nombre de un archivo con una extensión de archivo sin registrar (.mat, .fig, .txt).

• 3: name es un archivo MEX en su ruta de búsqueda de MATLAB.

• 4: name es un modelo de Simulink^® cargado o un modelo de Simulink o un archivo de biblioteca de su ruta de búsqueda de MATLAB.

• 5: name es una función de MATLAB integrada. No incluye las clases.

• 6: name es un archivo de código P en su ruta de búsqueda de MATLAB.

• 7: name es una carpeta.

• 8: name es una clase. (exist devuelve 0 para las clases de Java si inicia MATLAB con la opción -nojvm).

MATLAB realiza la búsqueda comenzando en la parte superior de la ruta de búsqueda y desplazándose hacia abajo hasta encontrar un resultado o alcanzar la última carpeta de la ruta. Si existe más de un name en una carpeta, MATLAB muestra la primera instancia de name, según Function Precedence Order. Las carpetas son una excepción para las reglas de prioridad de las funciones. Tienen prioridad sobre todos los tipos, salvo sobre las variables y funciones integradas.

Por ejemplo, si name coincide tanto con un archivo con una extensión .m como con un archivo de código P, exist devuelve 6, identificándolo como un archivo de código P. Si name coincide tanto con una variable como con un archivo de código P, exist devuelve 1, identificándolo como una variable. Si name coincide tanto con una carpeta como con una función de MATLAB, exist devuelve 7, identificándolo como una carpeta.

exist name searchType devuelve el tipo de name, restringiendo los resultados al tipo especificado searchType. Si name de tipo searchType no existe, MATLAB devuelve 0.

typeID = exist(___) devuelve el número correspondiente al tipo de name a typeID.

Ejemplos

Comprobar la existencia de una variable del área de trabajo

Cree una variable llamada testresults y, a continuación, confirme su existencia en el área de trabajo.

testresults = magic(5);
exist testresults

ans = 
1

Una variable llamada testresults existe en el área de trabajo.

Comprobar la existencia de una carpeta

Cree la carpeta myfolder y, a continuación, compruebe su existencia como carpeta.

mkdir myfolder;
exist myfolder dir

ans = 
7

Si especifica el tipo como file, MATLAB® busca tanto archivos como carpetas, devolviendo, por tanto, el mismo resultado.

exist myfolder file

ans = 
7

Comprobar si una función de MATLAB es una función integrada

Compruebe si la función plot es una función integrada o un archivo.

A = exist('plot')

A = 
5

Esto indica que plot es una función de MATLAB integrada.

Argumentos de entrada

name — Nombre de la variable, script, función, carpeta o clase

escalar de cadena | vector de caracteres

Nombre de la variable, script, función, carpeta o clase, especificado como escalar de cadena o vector de caracteres.

Para especificar name como ruta relativa, debe cumplir alguna de estas descripciones:

• Una carpeta en la ruta de búsqueda

• En una carpeta en la ruta de búsqueda

• La carpeta actual

• En la carpeta actual

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.

No se buscan las subcarpetas de carpetas de la ruta.

Si name especifica un archivo con una extensión de archivo sin registrar (.mat, .fig, .txt), incluya la extensión. También puede incluir una extensión para evitar conflictos con otros nombres de archivo similares. Por ejemplo, exist file.txt o exist("file.txt").

Nota

MATLAB no examina el contenido o la estructura interna de un archivo y se basa únicamente en la extensión del archivo para la clasificación.

searchType — Tipo de resultados que se desea buscar

builtin | class | dir | file | var

Tipo de resultados que se desea buscar, especificado como uno de los valores siguientes:

searchType	Descripción	Valores de retorno posibles
builtin	Comprueba solo funciones integradas.	5, 0
class	Comprueba solo clases.	8, 0
dir	Comprueba solo carpetas.	7, 0
file	Comprueba solo archivos o carpetas.	2, 3, 4, 6, 7, 0
var	Comprueba solo variables.	1, 0

Argumentos de salida

typeID — Tipo de identificador

valor numérico

Tipo de identificador, especificado como un valor numérico. Esta lista describe el tipo asociado a cada valor:

• 0: name no existe o no se puede encontrar por otras razones. Por ejemplo, si name existe en una carpeta restringida a la que MATLAB no tiene acceso, exist devuelve 0.

• 1: name es una variable en el área de trabajo.

• 2: name es un archivo con la extensión .m, .mlx o .mlapp, o name es el nombre de un archivo con una extensión de archivo sin registrar (.mat, .fig, .txt).

• 3: name es un archivo MEX en su ruta de búsqueda de MATLAB.

• 4: name es un modelo de Simulink cargado o un modelo de Simulink o un archivo de biblioteca de su ruta de búsqueda de MATLAB.

• 5: name es una función de MATLAB integrada. No incluye las clases.

• 6: name es un archivo de código P en su ruta de búsqueda de MATLAB.

• 7: name es una carpeta.

• 8: name es una clase. (exist devuelve 0 para las clases de Java si inicia MATLAB con la opción -nojvm).

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.

Funcionalidad alternativa

• Para comprobar la existencia de un archivo o carpeta, también puede usar las funciones isfolder o isfile. exist busca archivos y carpetas en la ruta de búsqueda, lo que puede dar lugar a resultados inesperados. isfolder y isfile buscan archivos o carpetas solo en la ruta especificada o en la carpeta actual, lo que puede dar lugar a resultados más claros y más rápidos.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• Los argumentos de entrada deben ser literales de cadenas o caracteres.

• Debe proporcionar el argumento de entrada searchType y solo los tipos de búsqueda "var", "file" y "dir".

• Cuando busca un archivo o carpeta, el generador de código trata la función exist como extrínseca. Por lo tanto, los tipos de búsqueda "file" y "dir" no son compatibles con la generación de código independiente. Para comprobar la existencia de un archivo o carpeta en la generación de código independiente, utilice las funciones isfolder e isfile.

• Si llama a exist usando un identificador de función, la generación de código no es compatible con el tipo de búsqueda "var".

• Buscar una variable local en una función solo se admite si esta variable está definida en todas las rutas de ejecución o en ninguna.

• Buscar variables locales no está admitido dentro de bucles, funciones anidadas o funciones anónimas.

• No se admite buscar varargout y repetir los argumentos de salida.

• En la generación de código, una variable global o persistente existe en todas las partes del cuerpo de la función donde la variable se declara. Por contraste, en la ejecución de MATLAB, una variable global o persistente existe solo después de que se declare en el cuerpo de la función.

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

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: Compatibilidad con generación de código C/C++

Puede generar código para llamadas a la función exist que buscan variables, con algunas limitaciones. Cuando busca un archivo o carpeta, el generador de código trata la función exist como extrínseca.

Consulte también

dir | inmem | what | which | who | isfolder | isfile

Temas

• Function Precedence Order
• ¿Qué es la ruta de búsqueda de MATLAB?
• Use is* Functions to Detect State