encoding/csv: document that Writer is buffered #30045
Labels
Documentation
FrozenDueToAge
NeedsFix
The path to resolution is known, but the work has not been done.
Milestone
csv.Writer
is implemented as abufio.Writer
, but this isn't clearly documented. The only place buffering is mentioned is in theWriter
example and in theFlush()
method. This makes it easy for a user to neglect to flush the underlying buffer and check for an error when writing a CSV, which can result in data loss. I believe the documentation oncsv.Writer
should clearly state that the implementation is buffered and thus must be flushed. Here is the current documentation:The text was updated successfully, but these errors were encountered: