readlines

以字符串数组形式读取文件行

全页折叠

    语法

    S = readlines(filename)
    S = readlines(filename,Name,Value)

    说明

    S = readlines(filename) 通过读取一个包含 N 行的文件创建一个 N×1 字符串数组。

    示例

    S = readlines(filename,Name,Value) 基于文件创建一个字符串数组，并通过一个或多个名称-值对组参量指定其他选项。例如，'EmptyLineRule','skip' 跳过空行。

    示例

    示例

    全部折叠

    打开实时脚本

    通过将文本文件中的每行作为一个单独字符串读取，创建一个 4×1 字符串数组。

    lines = readlines("badpoem.txt")
    lines = 4×1 string
    "Oranges and lemons,"
    "Pineapples and tea."
    "Orangutans and monkeys,"
    "Dragonflys or fleas."
    打开实时脚本

    查看文件 capital_cities.txt 的内容。

    type 'capital_cities.txt'
      Boston, Massachusetts

Albany, New York

  Sacramento, California

Columbus, Ohio

  Santa Fe, New Mexico

    通过在读取 capital_cities.txt 时跳过空行来创建一个 5×1 字符串数组。该数组仍然包含输入中的空白字符，但不包含空行。

    lines = readlines("capital_cities.txt","EmptyLineRule","skip")
    lines = 5×1 string
    "  Boston, Massachusetts"
    "Albany, New York"
    "  Sacramento, California"
    "Columbus, Ohio"
    "  Santa Fe, New Mexico"
    打开实时脚本

    查看文件 capital_cities.txt 的内容。

    type 'capital_cities.txt'
      Boston, Massachusetts

Albany, New York

  Sacramento, California

Columbus, Ohio

  Santa Fe, New Mexico

    将 'WhitespaceRule' 的值指定为 'trimleading'，以删除每行文本之前的空白。数组不再包含输入中的前导空白字符，但仍保留空行。

    lines = readlines("capital_cities.txt","WhitespaceRule","trimleading")
    lines = 10×1 string
    "Boston, Massachusetts"
    ""
    "Albany, New York"
    ""
    "Sacramento, California"
    ""
    "Columbus, Ohio"
    ""
    "Santa Fe, New Mexico"
    ""

    输入参数

    全部折叠

    要读取的文件的名称，指定为字符向量或字符串标量。

    根据文件的位置，filename 可以采用下列形式之一。

    位置

    形式

    当前文件夹或 MATLAB® 路径上的文件夹

    指定 filename 中文件的名称。

    例如：'myFile.txt'

    文件夹中的文件

    如果该文件不在当前文件夹或 MATLAB 路径下的文件夹中，则在 filename 中指定完整或相对路径。

    示例：'C:\myFolder\myFile.txt'

    示例：'dataDir\myFile.txt'

    Internet URL

    如果文件指定为 Internet 统一资源定位器 (URL)，则 filename 必须包含协议类型 'http://' 或 'https://'。

    例如：'http://hostname/path_to_file/my_data.csv'

    远程位置

    如果文件存储在远程位置，则 filename 必须包含用以下格式指定的文件的完整路径：

    scheme_name://path_to_file/my_file.ext

    根据远程位置，scheme_name 可以是下表中的值之一。

    远程位置scheme_name
    Amazon S3™s3
    Windows Azure® Blob 存储wasb, wasbs
    HDFS™hdfs

    有关详细信息，请参阅处理远程数据。

    示例：'s3://bucketname/path_to_file/my_file.csv'

    压缩文件格式作为文件读取。存档文件格式被视为文件夹。例如，函数将 mydatafiles.zip 解释为文件夹，因此必须在其中指定一个文件，如 mydatafiles.zip/file1.xlsx。对于以 .gz 扩展名结尾的文件，函数通过使用 .gz 之前的扩展名来确定文件格式。例如，mydata.csv.gz 作为 CSV 文件读取。 (自 R2025a 起)

    数据类型: char | string

    名称-值参数

    全部折叠

    以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

    在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

    示例: 'EmptyLineRule','skip' 指定在导入文件时忽略空行。

    行尾字符，指定为由 'LineEnding' 和一个字符向量或字符串组成的逗号分隔对组。该字符向量必须为 '\r\n'，或须指定单个字符。常用的行尾字符是换行符 ('\n') 或回车符 ('\r')。如果您指定 '\r\n'，则导入函数会将 \r 或 \n 以及两者的组合 (\r\n) 视为行尾字符。

    默认的行尾序列是 \n、\r 或 \r\n，具体取决于您的文件的内容。

    示例: 'LineEnding','\n'

    示例: 'LineEnding','\r\n'

    数据类型: char | string | cell

    要视为空白的字符，指定为包含一个或多个字符的字符向量或字符串标量。

    示例: 'Whitespace',' _'

    示例: 'Whitespace','?!.,'

    处理数据中行周围空白的过程，指定为 'preserve'、'trim'、'trimleading' 或 'trimtrailing'。

    空白规则

    行为

    'preserve'保留前导和尾随空白。
    'trim'删除前导和尾随空白。
    'trimleading'仅删除前导空白。
    'trimtrailing'仅删除尾随空白。

    示例: 'WhitespaceRule','trim'

    数据类型: char | string

    处理数据中的空行的方式，指定为 'skip'、'read' 或 'error'。

    空行规则

    行为

    'read'

    导入空行。

    'skip'

    跳过空行。

    'error'显示错误消息并中止导入操作。

    示例: 'EmptyLineRule','skip'

    数据类型: char | string

    与文件关联的字符编码方案，指定为以逗号分隔的对组，其中包含 'Encoding' 和 'system' 或标准字符编码方案名称。'Encoding','system' 使用系统默认编码。

    如果您没有指定任何编码，则该函数在读取文件时将使用自动字符集检测来确定编码。

    数据类型: char | string

    HTTP 或 HTTPS 请求选项，指定为 weboptions 对象。当指定的 filename 是包含协议类型 "http://" 或 "https://" 的 Internet URL 时，由 weboptions 对象确定如何导入数据。

    版本历史记录

    在 R2020b 中推出

    全部展开

    另请参阅

    | | | |