io.read()

类型 函数
io.*
返回值 字符串数字nil
修订 版本 2024.3703
关键词 io, read, 文件
另请参阅 io.open()
io.input()

概述

根据给定的格式读取由 io.input() 设置的文件。对于每个格式,函数返回一个包含读取字符的 字符串数字,如果无法以指定格式读取数据,则返回 nil。当不带格式调用时,它使用默认格式读取下一整行 ("*l")。

如果您正在从文件读取数据,则应使用 file:read() 而不是 io.read()

语法

io.read( [fmt1] [, fmt2] [, ...] )
fmt1, fmt2, … (可选)

字符串数字 决定要读取的数据类型/数量。可用的格式有

  • "*l" — 读取下一行(跳过行尾),在文件末尾 (EOF) 返回 nil。这是默认格式。
  • "*n" — 读取一个 数字;这是唯一返回 数字 而不是 字符串 的格式。
  • "*a" — 从当前位置开始读取整个文件。在文件末尾,它返回空字符串。
  • 数字 — 最多读取此数量的字符,在文件末尾返回 nil。如果此数字为 0,则不读取任何内容并返回一个空字符串,或者在文件末尾返回 nil