fopen

Abrir un archivo u obtener información sobre archivos abiertos

Sintaxis

fileID = fopen(filename)

fileID = fopen(filename,permission)

fileID = fopen(filename,permission,machinefmt,encodingIn)

[fileID,errmsg] = fopen(___)

filename = fopen(fileID)

[filename,permission,machinefmt,encodingOut] = fopen(fileID)

Descripción

fileID = fopen(filename) abre el archivo, filename, para tener acceso de lectura binario, y devuelve un identificador de archivo como un entero igual o mayor que 3. MATLAB^® reserva los identificadores de archivo 0, 1 y 2 para entrada estándar, salida estándar (la pantalla) y error estándar, respectivamente.

Si fopen no puede abrir el archivo, fileID es -1.

fileID = fopen(filename,permission) abre el archivo con el tipo de acceso especificado por permission.

fileID = fopen(filename,permission,machinefmt,encodingIn) también especifica el orden de los bytes o bits de lectura y escritura del archivo mediante el argumento machinefmt. El argumento opcional encodingIn especifica el esquema de codificación de caracteres asociado con el archivo.

[fileID,errmsg] = fopen(___) también devuelve un mensaje de error que depende del sistema si fopen no puede abrir el archivo. De lo contrario, errmsg es un vector de caracteres vacío. Puede utilizar esta sintaxis con cualquiera de los argumentos de entrada de las sintaxis anteriores.

filename = fopen(fileID) devuelve el nombre del archivo que usó una anterior llamada a fopen cuando abrió el archivo especificado por fileID. La salida filename contiene la ruta completa solo si la anterior llamada a fopen abrió el archivo con permisos r o r+. La función fopen no lee información del archivo para determinar el valor de salida.

[filename,permission,machinefmt,encodingOut] = fopen(fileID) también devuelve el permiso, el formato del equipo y la codificación que usó una anterior llamada a fopen cuando abrió el archivo especificado. Si el archivo se abrió en modo binario, permission incluye la letra 'b'. La salida encodingOut es un nombre de esquema de codificación estándar. fopen no lee información del archivo para determinar estos valores de salida. Un fileID no válido devuelve vectores de caracteres vacíos para todos los argumentos de salida.

Ejemplos

Abrir un archivo y pasar el identificador a la función de E/S de un archivo

Abra el archivo y pase el identificador del archivo la función fgetl para leer los datos.

Abra el archivo, tsunamis.txt, y obtenga el identificador.

fileID = fopen('tsunamis.txt');

Pase el fileID a la función fgetl para leer una línea del archivo.

tline = fgetl(fileID)

tline =

  'A global tsunami data set in xlsx format, comprising the following file:'

Cierre el archivo.

fclose(fileID)

Solicitar nombre del archivo que se desea abrir

Cree una línea de comandos para solicitar el nombre del archivo que desea abrir. Si fopen no puede abrir el archivo, muestre el mensaje de error correspondiente.

fileID = -1;
errmsg = '';
while fileID < 0 
   disp(errmsg);
   filename = input('Open file: ', 's');
   [fileID,errmsg] = fopen(filename);
end

Abrir un archivo para escritura y especificar el tipo de acceso, el orden de escritura y la codificación de caracteres

Abra un archivo para escribir en él utilizando la codificación de caracteres Shift-JIS.

fileID = fopen('japanese_out.txt','w','n','Shift_JIS');

La entrada 'w' especifica el acceso de escritura, la entrada 'n' especifica el orden de bytes nativo y 'Shift_JIS' especifica el esquema de codificación de caracteres.

Obtener información sobre archivos abiertos

Suponga que antes ha abierto un archivo utilizando fopen.

fileID = fopen('tsunamis.txt');

Obtenga los identificadores de archivo de todos los archivos abiertos.

fIDs = openedFiles

fIDs =

     3

Obtenga el nombre y la codificación de caracteres del archivo abierto. Utilice ~ en lugar de los argumentos de salida que quiera omitir.

[filename,~,~,encoding] = fopen(fileID)

filename =

    'matlabroot\toolbox\matlab\demos\tsunamis.txt'


encoding =

    'windows-1252'

La salida que se muestra aquí es representativa. Sus resultados podrían variar.

Argumentos de entrada

filename — Nombre del archivo que se desea abrir

escalar de cadena | vector de caracteres

Nombre del archivo que se desea abrir, especificado como escalar de cadena o vector de caracteres que incluye la extensión del archivo.

En los sistemas UNIX^®, si filename comienza por '~/' o '~username/', la función fopen expande la ruta hasta el directorio personal del usuario actual o especificado, respectivamente.

En función de la ubicación del archivo, filename puede tomar una de estas formas.

Carpeta actual o carpeta en la ruta de MATLAB	Especifique el nombre del archivo en filename. Si abre un archivo con acceso de lectura y no se encuentra en la carpeta actual, fopen lo busca en la ruta de búsqueda de MATLAB. Si abre un archivo con acceso de lectura o acceso para añadir y no se encuentra en la carpeta actual, fopen crea un archivo en el directorio actual. Ejemplo: "sample_file.txt"
Otras carpetas	Si el archivo no está en la carpeta actual o en una carpeta de la ruta de MATLAB, especifique el nombre de la ruta completa o relativa en filename. Ejemplo: "C:\myFolder\myFile.sample_file.txt" Ejemplo: "myFolder\sample_file.txt"
URL de Internet (desde R2024b)	Si especifica el archivo como un localizador uniforme de recursos de Internet (URL), filename debe contener el tipo de protocolo "http://" o "https://". Ejemplo: "http://hostname/path_to_file/my_data.csv"
Ubicación remota	Si el archivo está almacenado en una ubicación remota, filename debe contener la ruta completa del archivo, especificada como una URL con el formato siguiente: scheme_name://path_to_file/my_file.ext Según la ubicación remota, scheme_name puede ser uno de los valores de esta tabla. Ubicación remota scheme_name Amazon S3™ s3 Windows Azure® Blob Storage wasb, wasbs HDFS™ hdfs Si utiliza un sistema de archivos en la nube, establezca variables de entorno para comunicarse con el sistema de archivos remoto. Para obtener más información, consulte Trabajar con datos remotos. Los archivos de un volumen de Sistema de archivos distribuido de Hadoop (HDFS) no se pueden abrir en el modo de lectura o escritura. Ejemplo: "s3://bucketname/path_to_file/sample_file.txt"

Ejemplo: "myFile.txt"

permission — Tipo de acceso a archivos

'r' (predeterminado) | 'w' | 'a' | 'r+' | 'w+' | 'a+' | 'A' | 'W' | ...

Tipo de acceso a archivos, especificado como un vector de caracteres o un escalar de cadena. Puede abrir un archivo en el modo binario o en el modo texto. En los sistemas UNIX, ambos modos de traslación tienen el mismo efecto. Para abrir un archivo en el modo binario, especifique uno de los siguientes.

'r'	Abrir un archivo para su lectura.
'w'	Abrir o crear un nuevo archivo para su escritura. Descartar el contenido existente, si lo hay.
'a'	Abrir o crear un nuevo archivo para su escritura. Añadir información al final del archivo.
'r+'	Abrir un archivo para su lectura o escritura.
'w+'	Abrir o crear un nuevo archivo para su lectura o escritura. Descartar el contenido existente, si lo hay.
'a+'	Abrir o crear un nuevo archivo para su lectura o escritura. Añadir información al final del archivo.
'A'	Abrir un archivo para añadir información sin vaciar automáticamente el buffer de salida actual.
'W'	Abrir un archivo para su escritura sin vaciar automáticamente el buffer de salida actual.

Para abrir archivos en el modo texto, añada la letra 't' al argumento permission, como 'rt' o 'wt+'.

En el modo texto de sistemas Windows^®:

• Las operaciones de lectura que detectan un retorno de carro seguido de un carácter de línea nueva ('\r\n') eliminan el retorno de carro de la entrada.

• Las operaciones de escritura insertan un retorno de carro antes que cualquier carácter de línea nueva en la entrada.

Abra o cree un nuevo archivo en el modo texto si quiere escribir en él en MATLAB y luego abrirlo en el Bloc de notas de Microsoft^® o cualquier otro editor de texto que no reconozca '\n' como una secuencia de línea nueva. Al escribir en el archivo, termine cada línea con '\r\n'. Para ver un ejemplo, consulte fprintf. De lo contrario, abra los archivos en el modo binario para conseguir un mejor rendimiento.

Para leer y escribir un mismo archivo:

• Abra el archivo con un valor para permission que incluya el signo más, '+'.

• Llame a fseek o a frewind entre las operaciones de lectura y escritura. Por ejemplo, no llame a fread seguido de fwrite, o a fwrite seguido de fread, a menos que llame a fseek o a frewind entre ambas operaciones.

Tipos de datos: char | string

machinefmt — Orden de los bytes o bits de lectura o escritura

'n' (predeterminado) | 'b' | 'l' | 's' | 'a' | ...

Orden de los bytes o bits de lectura o escritura, especificado como uno de los siguientes vectores de caracteres o escalares de cadena.

'n' o 'native'	El orden de bytes de su sistema (predeterminado)
'b' o 'ieee-be'	Orden big-endian
'l' o 'ieee-le'	Orden little-endian
's' o 'ieee-be.l64'	Orden big-endian, tipo de datos largo de 64 bits
'a' o 'ieee-le.l64'	Orden little-endian, tipo de datos largo de 64 bits

De forma predeterminada, todas las plataformas compatibles actuales utilizan el orden little-endian para archivos nuevos. Los archivos binarios ya existentes pueden usar tanto el sistema de orden big-endian como little-endian.

Tipos de datos: char | string

encodingIn — Codificación de caracteres

'UTF-8' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' | ...

Codificación de caracteres para utilizar operaciones de lectura y escritura posteriores, incluidas fscanf, fprintf, fgetl, fgets, fread y fwrite, especificada como vector de caracteres o escalar de cadena. El vector de caracteres o escalar de cadena debe contener un nombre de esquema de codificación de caracteres estándar como los siguientes:

"Big5"	"ISO-8859-1"	"windows-874"
"Big5-HKSCS"	"ISO-8859-2"	"windows-949"
"CP949"	"ISO-8859-3"	"windows-1250"
"EUC-KR"	"ISO-8859-4"	"windows-1251"
"EUC-JP"	"ISO-8859-5"	"windows-1252"
"EUC-TW"	"ISO-8859-6"	"windows-1253"
"GB18030"	"ISO-8859-7"	"windows-1254"
"GB2312"	"ISO-8859-8"	"windows-1255"
"GBK"	"ISO-8859-9"	"windows-1256"
"IBM866"	"ISO-8859-11"	"windows-1257"
"KOI8-R"	"ISO-8859-13"	"windows-1258"
"KOI8-U"	"ISO-8859-15"	"US-ASCII"
	"Macintosh"	"UTF-8"
	"Shift_JIS"

Si no especifica un esquema de cifrado al abrir un archivo para lectura, fopen utiliza la detección automática del conjunto de caracteres para determinar la codificación. Si no especifica un esquema de cifrado al abrir un archivo para escritura, fopen utiliza de forma predeterminada UTF-8 para permitir la interoperabilidad entre todas las plataformas y configuraciones locales sin pérdida de datos ni daños. Para obtener más información, consulte Importar archivos de datos de texto con E/S de bajo nivel.

Si especifica un valor de codificación que no esté en la lista de valores compatibles, MATLAB emite una advertencia. Al especificar otros nombres de codificación, a veces, no siempre, se producen resultados correctos.

Tipos de datos: char | string

fileID — Identificador de archivo de un archivo abierto

valor entero

Identificador de archivo de un archivo abierto, especificado como entero.

Tipos de datos: double

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

• En la mayoría de los casos, no es necesario abrir un archivo en el modo texto. Las funciones de importación de MATLAB, todas las aplicaciones de UNIX y Microsoft Word y WordPad reconocen '\n' como un indicador de línea nueva.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• La generación de código no es compatible con:

  • Los argumentos de entrada machinefmt encodingIn o fileID.

  • El argumento de salida errmsg.

  • Abrir un archivo en modo texto. Es decir, el argumento permission no debe contener la letra t. Por ejemplo, el valor no puede ser 'rt'.

• El argumento permission puede contener como máximo tres caracteres. Los caracteres deben ser únicos.

• Si deshabilita las llamadas extrínsecas, no podrá devolver identificadores de archivos creados con fopen a funciones de MATLAB o a funciones extrínsecas. Utilice estos identificadores de archivo solo de forma interna.

• Al generar ejecutables C/C++ o librerías estáticas o dinámicas, puede abrir hasta 20 archivos.

• El código generado no informa de errores de identificadores de archivo no válidos. Escriba su propio mensaje de error al abrir el archivo en su código MATLAB. Pruebe si fopen devuelve -1, lo que indica que no se ha podido abrir el archivo. Por ejemplo:

  ...
  fid = fopen(filename, 'r');
  if fid == -1
  		% fopen failed
  
  else
  % fopen successful, okay to call fread
  A = fread(fid);
  ...

• El comportamiento del código generado para fread dependerá del compilador si:

  1. Abre un archivo utilizando fopen con un permission de a+.

  2. Lea el archivo utilizando fread antes de llamar a una función de E/S, como fseek o frewind, que define el indicador de posición del archivo.

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

R2025a: fopen ya no admite la opción "all"

fopen ya no admite la opción "all". Para obtener los identificadores de archivo de todos los archivos abiertos, utilice en su lugar la función openedFiles. Este cambio se anunció en la versión R2024a y entró en vigor en la versión R2025a.

R2024b: Leer datos a través de HTTP y HTTPS con funciones de archivos de bajo nivel

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

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

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

Consulte también

fclose | openedFiles | ferror | fseek | ftell | feof | fscanf | fprintf | fread | fwrite | frewind