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 。