bids_tsv.h File Reference

Generic tab-separated-value reader/writer for BIDS sidecars (UTF-8, LF, n/a for missing values, mandatory header row). More...

#include "bids_global.h"
#include <QSharedPointer>
#include <QString>
#include <QStringList>
#include <QList>
#include <QMap>

Include dependency graph for bids_tsv.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	BIDSLIB::BidsTsv
	Generic BIDS TSV file I/O. More...

Namespaces
namespace	BIDSLIB
	BIDS dataset reading, writing, path construction, and sidecar metadata handling for iEEG/EEG/MEG.

Typedefs
using	BIDSLIB::BidsTsvRow = QMap<QString, QString>

Detailed Description

Generic tab-separated-value reader/writer for BIDS sidecars (UTF-8, LF, n/a for missing values, mandatory header row).

SPDX-License-Identifier: BSD-3-Clause Copyright (c) 2026 MNE-CPP Authors

Author

Christoph Dinh chris.nosp@m.toph.nosp@m..dinh.nosp@m.@mne.nosp@m.-cpp..nosp@m.org

Since

2.1.0

Date

March 2026

BIDS standardises a strict TSV dialect for every tabular sidecar: a mandatory header row defines the column names, values are separated by single literal tabs, missing values are encoded as the three-byte string n/a, and the file MUST be UTF-8 encoded with LF (no CR) line terminators. BidsTsv implements that dialect once via BidsTsv::readTsv / BidsTsv::writeTsv so the domain-specific wrappers BidsChannel, BidsElectrode and BidsEvent do not each re-derive it. Rows are returned as ordered column-name → value maps (BidsTsvRow), preserving the header ordering for round-trip-stable writes.

Definition in file bids_tsv.h.