Csv Serializer¶

1

import "std/text/csv-serializer";

CsvSerializer struct¶

Serializer for CSV (comma-separated values) output.

Fields are quoted when necessary and embedded quotes are escaped by doubling, so the output round-trips through the CsvParser from "std/text/csv-parser" when both use the same control characters.

Constructors¶

ctor¶

1

public p CsvSerializer.ctor(char delimiter = DEFAULT_DELIMITER, char quote = DEFAULT_QUOTE)

Construct a CSV serializer with the given control characters

Parameters

Methods¶

serializeField¶

1

public f<String> CsvSerializer.serializeField(const String& field)

Serializes a single field, quoting it when necessary.

A field is wrapped in quotes when it contains the delimiter, the quote character or a line terminator. Embedded quotes are escaped by doubling, so the result round-trips through parseLine/parse. The empty field is also quoted (as ""): an empty record would otherwise serialize to an empty line, which parse does not reproduce as a row.

Parameters

Returns: String — Serialized (and possibly quoted) field

serializeRow¶

1

public f<String> CsvSerializer.serializeRow(const Vector<String>& row)

Serializes a single row into one CSV record. Fields are separated by the configured delimiter; no trailing line terminator is appended.

Parameters

Returns: String — Serialized CSV record

serialize¶

1

public f<String> CsvSerializer.serialize(const Vector<Vector<String>>& rows)

Serializes a whole document into CSV text. Records are separated by \r\n as recommended by RFC 4180; no trailing line terminator is appended, so parse(serialize(rows)) reproduces the input rows.

Parameters

Returns: String — Serialized CSV document