readlines

Leer líneas de archivos como arreglos de cadenas

Sintaxis

S = readlines(filename)

S = readlines(filename,Name,Value)

Descripción

S = readlines(filename) crea un arreglo de cadenas de N por 1 leyendo un archivo de N líneas.

S = readlines(filename,Name,Value) crea un arreglo de cadenas a partir de un archivo con opciones adicionales especificadas por uno o más argumentos de par nombre-valor. Por ejemplo, 'EmptyLineRule','skip' omite las líneas vacías.

Ejemplos

Crear arreglos de cadenas a partir de archivos de texto

Cree un arreglo de cadenas de 4 por 1 leyendo cada línea de un archivo de texto como una cadena aparte.

lines = readlines("badpoem.txt")

lines = 4×1 string
    "Oranges and lemons,"
    "Pineapples and tea."
    "Orangutans and monkeys,"
    "Dragonflys or fleas."

Ignorar líneas vacías en un archivo de texto

Visualice el contenido del archivo capital_cities.txt.

type 'capital_cities.txt'

  Boston, Massachusetts

Albany, New York

  Sacramento, California

Columbus, Ohio

  Santa Fe, New Mexico

Cree un arreglo de cadenas de 5 por 1 omitiendo las líneas vacías mientras lee capital_cities.txt. El arreglo todavía contiene los caracteres de espacio de la entrada, pero no las líneas vacías.

lines = readlines("capital_cities.txt","EmptyLineRule","skip")

lines = 5×1 string
    "  Boston, Massachusetts"
    "Albany, New York"
    "  Sacramento, California"
    "Columbus, Ohio"
    "  Santa Fe, New Mexico"

Eliminar espacios en blanco alrededor de texto

Visualice el contenido del archivo capital_cities.txt.

type 'capital_cities.txt'

  Boston, Massachusetts

Albany, New York

  Sacramento, California

Columbus, Ohio

  Santa Fe, New Mexico

Especifique el valor de 'WhitespaceRule' como 'trimleading' para eliminar los espacios en blanco antes de cada línea de texto. El arreglo ya no contiene los caracteres de espacio iniciales de la entrada, pero aún conserva las líneas vacías.

lines = readlines("capital_cities.txt","WhitespaceRule","trimleading")

lines = 10×1 string
    "Boston, Massachusetts"
    ""
    "Albany, New York"
    ""
    "Sacramento, California"
    ""
    "Columbus, Ohio"
    ""
    "Santa Fe, New Mexico"
    ""

Argumentos de entrada

filename — Nombre del archivo que se desea leer

vector de caracteres | escalar de cadena

Nombre del archivo que se desea leer, especificado como vector de caracteres o escalar de cadena.

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

Ubicación	Forma
Carpeta actual o carpeta en la ruta de MATLAB®	Especifique el nombre del archivo en filename. Ejemplo: 'myFile.txt'
Archivo en una carpeta	Si el archivo no está en la carpeta actual o en una carpeta de la ruta de MATLAB, especifique la ruta completa o relativa en filename. Ejemplo: 'C:\myFolder\myFile.txt' Ejemplo: 'dataDir\myFile.txt'
URL de Internet	Si el archivo se especifica 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 especificado 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 Para obtener más información, consulte Trabajar con datos remotos. Ejemplo: 's3://bucketname/path_to_file/my_file.csv'

Los formatos de archivo comprimidos se leen como archivos. Los formatos de archivo archivados se tratan como carpetas. Por ejemplo, la función interpreta mydatafiles.zip como una carpeta, por lo que debe especificar un archivo dentro de ella, como mydatafiles.zip/file1.xlsx. Para los archivos que terminan con la extensión .gz, la función determina el formato de archivo utilizando la extensión que precede a .gz. Por ejemplo, mydata.csv.gz se lee como un archivo CSV. (desde R2025a)

Tipos de datos: char | string

Argumentos de par nombre-valor

Especifique pares opcionales de argumentos como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.

En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: 'EmptyLineRule','skip' especifica que deben omitirse las líneas vacías mientras se importa el archivo.

LineEnding — Caracteres de final de línea

{'\n','\r','\r\n'} (predeterminado) | vector de caracteres | escalar de cadena | arreglo de celdas de vectores de caracteres | arreglo de cadenas

Caracteres de final de línea, especificados como el par separado por comas que consta de 'LineEnding' y un vector de caracteres o cadena. El vector de caracteres debe ser '\r\n' o debe especificar un solo carácter. Los caracteres de final de línea comunes son un carácter de línea nueva ('\n') o un retorno de carro ('\r'). Si especifica '\r\n', la función de importación trata \r, \n o la combinación de los dos (\r\n) como caracteres de final de línea.

La secuencia de final de línea predeterminada es \n, \r o \r\n, en función del contenido del archivo.

Ejemplo: 'LineEnding','\n'

Ejemplo: 'LineEnding','\r\n'

Tipos de datos: char | string | cell

Whitespace — Caracteres que se desea tratar como espacios en blanco

{' ','\b','\t'} | vector de caracteres | escalar de cadena

Caracteres que se desea tratar como espacios en blanco, especificados como vector de caracteres o escalar de cadena que contienen uno o más caracteres.

Ejemplo: 'Whitespace',' _'

Ejemplo: 'Whitespace','?!.,'

WhitespaceRule — Procedimiento para gestionar espacios en blanco

'preserve' (predeterminado) | 'trim' | 'trimleading' | 'trimtrailing'

Procedimiento para gestionar espacios en blanco alrededor de una línea en los datos, especificado como 'preserve', 'trim', 'trimleading' o 'trimtrailing'.

Regla de espacios en blanco	Comportamiento
'preserve'	Conserva los espacios en blanco iniciales y finales.
'trim'	Elimina los espacios en blanco iniciales y finales.
'trimleading'	Elimina únicamente los espacios en blanco iniciales.
'trimtrailing'	Elimina únicamente los espacios en blanco finales.

Ejemplo: 'WhitespaceRule','trim'

Tipos de datos: char | string

EmptyLineRule — Procedimiento para gestionar líneas vacías

'read' (predeterminado) | 'skip' | 'error'

Procedimiento para gestionar líneas vacías en los datos, especificado como 'skip', 'read' o 'error'.

Regla de líneas vacías	Comportamiento
'read'	Importa líneas vacías.
'skip'	Omite líneas vacías.
'error'	Muestra un mensaje de error y anula la operación de importación.

Ejemplo: 'EmptyLineRule','skip'

Tipos de datos: char | string

Encoding — Esquema de codificación de caracteres

'' (predeterminado) | 'UTF-8' | 'system' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' | ...

Esquema de codificación de caracteres asociado al archivo, especificado como el par separado por comas que consta de 'Encoding' y 'system' o un nombre de esquema de codificación de caracteres estándar. 'Encoding','system' utiliza la codificación predeterminada del sistema.

Cuando no se especifica ninguna codificación, la función utiliza la detección automática del conjunto de caracteres para determinar la codificación al leer el archivo.

Tipos de datos: char | string

WebOptions — Opciones de solicitud HTTP o HTTPS

objeto weboptions

Opciones de solicitud HTTP o HTTPS, especificadas como un objeto weboptions. El objeto weboptions determina cómo importar datos cuando el filename especificado es una URL de Internet que contiene el tipo de protocolo "http://" o "https://".

Historial de versiones

Introducido en R2020b

R2025a: Leer datos de archivos comprimidos y archivados

Puede leer datos de archivos comprimidos y archivados como un arreglo de cadenas.

Consulte también

writelines | readtable | readtimetable | readmatrix | readvars