fileread

Leer el contenido de un archivo como texto

Sintaxis

text = fileread(filename)

text = fileread(filename,Encoding=encoding)

Descripción

text = fileread(filename) devuelve el contenido del archivo filename como un vector de caracteres.

text = fileread(filename,Encoding=encoding) abre el nombre de archivo utilizando la codificación especificada por encoding.

ejemplo

Ejemplos

contraer todo

Buscar texto en un archivo

Abrir script en vivo

Lea un archivo y busque en él el texto que le interese.

Primero, lea el archivo fileread.m en un vector de caracteres.

filetext = fileread('fileread.m');

A continuación, defina el texto que desea buscar.

expr = '[^\n]*fileread[^\n]*';

Busque y devuelva todas las líneas que contengan el texto 'fileread'.

matches = regexp(filetext,expr,'match');

Muestre la primera línea que coincide.

disp(matches{1})

function out = fileread(filename,args)

Argumentos de entrada

contraer todo

`filename` — Nombre del archivo que se desea leer
escalar de cadena | vector de caracteres

Nombre del archivo que se desea leer, especificado como escalar de cadena o vector de caracteres que incluye la extensión del archivo. fileread usa detección automática del conjunto de caracteres para determinar la codificación del archivo.

En los sistemas UNIX^®, si filename comienza por '~/' o '~username/', la función fileread 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, fileread lo busca en la ruta de búsqueda de MATLAB.

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.

Ejemplo: "s3://bucketname/path_to_file/sample_file.txt"

Ejemplo: "myFile.dat"

`encoding` — Esquema de codificación de caracteres
`""` | `"UTF-8"` | `"ISO-8859-1"` | `"windows-1251"` | `"windows-1252"` | ...

Esquema de codificación de caracteres asociado al archivo, especificado como "" o un nombre de esquema de codificación de caracteres estándar como uno de los valores de esta tabla. Cuando no se especifica ninguna codificación o se especifica la codificación como "", la función fileread utiliza la codificación de MATLAB predeterminada para leer el archivo.

`"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"`

Ejemplo: Encoding="system" utiliza la codificación predeterminada del sistema.

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.

Capacidades ampliadas

expandir todo

Generación de código C/C++
Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

Si la función fileread lee el archivo completo, todos los datos deben caber en el arreglo más grande que esté disponible para generar código.
El generador de código de la función fileread trata el valor char de origen o salida como un entero de 8 bits con signo. Use solo valores entre 0 y 127.

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

expandir todo

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