Data structure for representing CSV rows. More...

#include <csv_row.hpp>

Classes
class	iterator
	A random access iterator over the contents of a CSV row. More...

Public Types
using	reverse_iterator = std::reverse_iterator< iterator >
	A reverse iterator over the contents of a CSVRow.

Public Member Functions
	CSVRow (internals::RawCSVDataPtr _data)
	Construct a CSVRow view over parsed row storage.

	CSVRow (internals::RawCSVDataPtr _data, size_t _data_start, size_t _field_bounds)

	CSVRow (internals::RawCSVDataPtr _data, size_t _data_start, size_t _field_bounds, size_t _row_length)

CONSTEXPR bool	empty () const noexcept
	Indicates whether row is empty or not.

CONSTEXPR size_t	size () const noexcept
	Return the number of fields in this row.

size_t	byte_offset () const noexcept
	Return the absolute byte offset where this row starts in the source.

Value Retrieval
CSVField	operator[] (size_t n) const
	Return the field at `n`.

CSVField	operator[] (csv::string_view col_name) const
	Return the field named `col_name`.

std::string	to_json (const std::vector< std::string > &subset={}) const

std::string	to_json_array (const std::vector< std::string > &subset={}) const

const std::vector< std::string > &	get_col_names () const
	Retrieve this row's associated column names.

internals::ConstColNamesPtr	col_names_ptr () const noexcept
	Internal accessor for preserving resolved column-name lookup policy across helper types.

std::unordered_map< std::string, std::string >	to_unordered_map () const
	Convert this CSVRow into an unordered map.

std::unordered_map< std::string, std::string >	to_unordered_map (const std::vector< std::string > &subset) const
	Convert a selected subset of columns into an unordered map.

auto	to_sv_range () const
	Convert this CSVRow into a std::ranges::input_range of string_views.

	operator std::vector< std::string > () const
	Convert this row into a `std::vector<std::string>`.

csv::string_view	raw_str () const noexcept
	Return a string_view of the raw bytes of this row as they appear in the underlying parse buffer, up to (but not including) the trailing record terminator.

Iterators
Each iterator points to a CSVField object.
iterator	begin () const
	Return an iterator pointing to the first field.

iterator	end () const noexcept
	Return an iterator pointing to just after the end of the CSVRow.

reverse_iterator	rbegin () const noexcept

reverse_iterator	rend () const

Friends
template<typename RowSink , typename ParsePolicy , typename FieldPolicy , typename RowPolicy >
class	internals::CSVParserCore

struct	internals::CSVRowRowPolicy

struct	internals::speculative::CSVRowFragment

Detailed Description

Data structure for representing CSV rows.

Definition at line 544 of file csv_row.hpp.

Member Typedef Documentation

◆ reverse_iterator

using csv::CSVRow::reverse_iterator = std::reverse_iterator<iterator>

A reverse iterator over the contents of a CSVRow.

Definition at line 686 of file csv_row.hpp.

Constructor & Destructor Documentation

◆ CSVRow() [1/3]

csv::CSVRow::CSVRow ( internals::RawCSVDataPtr _data )

inline

Construct a CSVRow view over parsed row storage.

Definition at line 555 of file csv_row.hpp.

◆ CSVRow() [2/3]

csv::CSVRow::CSVRow	(	internals::RawCSVDataPtr	_data,
		size_t	_data_start,
		size_t	_field_bounds
	)

inline

Definition at line 556 of file csv_row.hpp.

◆ CSVRow() [3/3]

csv::CSVRow::CSVRow	(	internals::RawCSVDataPtr	_data,
		size_t	_data_start,
		size_t	_field_bounds,
		size_t	_row_length
	)

inline

Definition at line 558 of file csv_row.hpp.

Member Function Documentation

◆ begin()

CSVRow::iterator csv::CSVRow::begin ( ) const

Return an iterator pointing to the first field.

Definition at line 170 of file csv_row.cpp.

◆ byte_offset()

size_t csv::CSVRow::byte_offset ( ) const

inlinenoexcept

Return the absolute byte offset where this row starts in the source.

Definition at line 568 of file csv_row.hpp.

◆ col_names_ptr()

internals::ConstColNamesPtr csv::CSVRow::col_names_ptr ( ) const

inlinenoexcept

Internal accessor for preserving resolved column-name lookup policy across helper types.

Definition at line 595 of file csv_row.hpp.

◆ empty()

CONSTEXPR bool csv::CSVRow::empty ( ) const

inlinenoexcept

Indicates whether row is empty or not.

Definition at line 562 of file csv_row.hpp.

◆ end()

CSVRow::iterator csv::CSVRow::end ( ) const

noexcept

Return an iterator pointing to just after the end of the CSVRow.

Warning: Attempting to dereference the end iterator results in dereferencing a null pointer.

Definition at line 179 of file csv_row.cpp.

◆ get_col_names()

const std::vector< std::string > & csv::CSVRow::get_col_names ( ) const

inline

Retrieve this row's associated column names.

Definition at line 590 of file csv_row.hpp.

◆ operator std::vector< std::string >()

csv::CSVRow::operator std::vector< std::string > ( ) const

Convert this row into a std::vector<std::string>.

This conversion is primarily intended for write-side workflows, such as reordering or selecting columns before forwarding the row to CSVWriter.

Note: This is less efficient than indexed access via operator[] because it materializes all fields as owning strings.

◆ operator[]() [1/2]

CSVField csv::CSVRow::operator[] ( csv::string_view col_name ) const

Return the field named col_name.

Throws std::runtime_error if the name is absent.

Definition at line 33 of file csv_row.cpp.

◆ operator[]() [2/2]

CSVField csv::CSVRow::operator[] ( size_t n ) const

Return the field at n.

Throws std::runtime_error if the index is out of bounds.

Definition at line 29 of file csv_row.cpp.

◆ raw_str()

csv::string_view csv::CSVRow::raw_str ( ) const

noexcept

Return a string_view of the raw bytes of this row as they appear in the underlying parse buffer, up to (but not including) the trailing record terminator.

Warning: The view is only valid for as long as the CSVRow (and its associated data chunk) remains alive.

Definition at line 50 of file csv_row.cpp.

◆ rbegin()

CSVRow::reverse_iterator csv::CSVRow::rbegin ( ) const

noexcept

Definition at line 183 of file csv_row.cpp.

◆ rend()

CSVRow::reverse_iterator csv::CSVRow::rend ( ) const

Definition at line 187 of file csv_row.cpp.

◆ size()

CONSTEXPR size_t csv::CSVRow::size ( ) const

inlinenoexcept

Return the number of fields in this row.

Definition at line 565 of file csv_row.hpp.

◆ to_json()

std::string csv::CSVRow::to_json ( const std::vector< std::string > & subset = {} ) const

inline

Definition at line 578 of file csv_row.hpp.

◆ to_json_array()

std::string csv::CSVRow::to_json_array ( const std::vector< std::string > & subset = {} ) const

inline

Definition at line 583 of file csv_row.hpp.

◆ to_sv_range()

auto csv::CSVRow::to_sv_range ( ) const

inline

Convert this CSVRow into a std::ranges::input_range of string_views.

Note: Requires C++20 or later.

Definition at line 614 of file csv_row.hpp.

◆ to_unordered_map() [1/2]

std::unordered_map< std::string, std::string > csv::CSVRow::to_unordered_map ( ) const

Convert this CSVRow into an unordered map.

Build a map from column names to values for a given row.

The keys are the column names and the values are the corresponding field values.

Definition at line 69 of file csv_row.cpp.

◆ to_unordered_map() [2/2]

std::unordered_map< std::string, std::string > csv::CSVRow::to_unordered_map ( const std::vector< std::string > & subset ) const

Convert a selected subset of columns into an unordered map.

Build a map from a subset of column names to values for a given row.

Definition at line 82 of file csv_row.cpp.

Friends And Related Symbol Documentation

◆ internals::CSVParserCore

template<typename RowSink , typename ParsePolicy , typename FieldPolicy , typename RowPolicy >

friend class internals::CSVParserCore

friend

Definition at line 547 of file csv_row.hpp.

◆ internals::CSVRowRowPolicy

friend struct internals::CSVRowRowPolicy

friend

Definition at line 548 of file csv_row.hpp.

◆ internals::speculative::CSVRowFragment

friend struct internals::speculative::CSVRowFragment

friend

Definition at line 550 of file csv_row.hpp.

The documentation for this class was generated from the following files:

include/internal/csv_row.hpp
include/internal/csv_row.cpp

Classes

Public Types

Public Member Functions

Friends

Detailed Description

Member Typedef Documentation

◆ reverse_iterator

Constructor & Destructor Documentation

◆ CSVRow() [1/3]

◆ CSVRow() [2/3]

◆ CSVRow() [3/3]

Member Function Documentation

◆ begin()

◆ byte_offset()

◆ col_names_ptr()

◆ empty()

◆ end()

◆ get_col_names()

◆ operator std::vector< std::string >()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ raw_str()

◆ rbegin()

◆ rend()

◆ size()

◆ to_json()

◆ to_json_array()

◆ to_sv_range()

◆ to_unordered_map() [1/2]

◆ to_unordered_map() [2/2]

Friends And Related Symbol Documentation

◆ internals::CSVParserCore

◆ internals::CSVRowRowPolicy

◆ internals::speculative::CSVRowFragment