Elixir File.stream!用法及代码示例

@spec stream!(Path.t(), [stream_mode()], :line | pos_integer()) :: File.Stream.t()

使用给定的 modes 返回给定 path 的 File.Stream 。

该流实现了 Enumerable 和 Collectable 协议，这意味着它可以用于读取和写入。

line_or_bytes 参数配置流式传输时文件的读取方式，通过 :line(默认)或给定的字节数。使用 :line 选项时，CRLF 换行符 (" ") 被标准化为 LF (" ")。

由于与 File.open!/2 相同的原因，操作流在打开时可能会失败。请注意，每次流式传输开始时都会自动打开该文件。不需要通过 :read 和 :write 模式，因为它们是由 Elixir 自动设置的。

原始文件

由于 Elixir 控制何时打开流文件，因此无法共享底层设备，因此出于性能原因以原始模式打开文件很方便。因此，除非指定了编码，否则 Elixir 将使用 :read_ahead 选项以 :raw 模式打开流。这意味着流入文件的任何数据都必须转换为 iodata/0 类型。例如，如果您在模式参数中传递[encoding: :utf8] 或[encoding: {:utf16, :little}]，则底层流将使用 IO.write/2 和 String.Chars 协议来转换数据。请参阅 IO.binwrite/2 和 IO.write/2 。

如果要在紧密循环下写入流，也可以考虑传递 :delayed_write 选项。

字节顺序标记

如果您在模式参数中传递:trim_bom，则在从文件读取时，流将修剪 UTF-8、UTF-16 和 UTF-32 字节顺序标记。

请注意，此函数不会尝试根据 BOM 发现文件编码。

例子

# Read in 2048 byte chunks rather than lines
File.stream!("./test/test.data", [], 2048)
#=> %File.Stream{line_or_bytes: 2048, modes: [:raw, :read_ahead, :binary],
#=>   path: "./test/test.data", raw: true}

有关流式传输到文件的示例，请参见 Stream.run/1 。