Csv Parser¶

1

import "std/text/csv-parser";

CsvParser struct¶

Parser for CSV (comma-separated values) input.

Supports quoted fields, embedded delimiters/newlines and escaped quotes (by doubling, e.g. "" inside a quoted field yields a single "). Both \n and \r\n are accepted as line terminators.

Constructors¶

ctor¶

1

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

Construct a CSV parser with the given control characters

Parameters

Methods¶

parseLine¶

1

public f<Vector<String>> CsvParser.parseLine(const String& input)

Parses a single CSV record into its fields. Newlines inside the input are preserved as part of the field they appear in.

Parameters

Returns: Vector<String> — Parsed fields

parse¶

1

public f<Vector<Vector<String>>> CsvParser.parse(const String& input)

Parses a whole CSV document into rows, where each row is a vector of fields.

An optional trailing line terminator is not treated as an additional empty record. Empty input yields an empty result.

Parameters

Returns: Vector<Vector<String>> — Parsed rows

serializeField¶

1

public f<String> CsvParser.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> CsvParser.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> CsvParser.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