Data type representing individual CSV values. More...

#include <csv_row.hpp>

Public Member Functions
constexpr	CSVField (csv::string_view _sv) noexcept
	Constructs a CSVField from a string_view.

	CSVField (csv::string_view _sv, const internals::CSVFieldScalar &scalar) noexcept

	operator csv::string_view () const noexcept

	operator std::string () const

template<typename T = std::string>
T	get () const
	Returns the value casted to the requested type, performing type checking before.

template<typename T = std::string>
std::expected< T, CSVConversionError >	as () const
	Return this field as T, preserving conversion failure as CSVConversionError.

template<typename T = std::string>
bool	try_get (T &out) const noexcept
	Non-throwing equivalent of get().

template<typename T >
bool	try_get (T &out, CSVConversionError &error) const noexcept
	Convert with the same rules as try_get(), retaining the failure reason.

template<typename T >
	operator std::optional< T > () const
	Convert this field to std::optional<T>, returning std::nullopt when conversion fails.

template<typename T = long long>
bool	try_parse_hex (T &parsedValue) const
	Parse a hexadecimal value, returning false if the value is not hex.

bool	try_parse_decimal (long double &dVal, const char decimalSymbol='.')
	Attempts to parse a decimal (or integer) value using the given symbol, returning `true` if the value is numeric.

bool	try_parse_timestamp (std::uint64_t &out) const noexcept
	Parse this field as Unix milliseconds.

template<typename T >
bool	try_parse_timestamp (T &out) const noexcept
	Parse this field as Unix milliseconds in a 64-bit unsigned integer.

template<typename Rep , typename Period >
bool	try_parse_timestamp (std::chrono::duration< Rep, Period > &out) const noexcept
	Parse this field as a timestamp duration since the Unix epoch.

template<typename Duration >
bool	try_parse_timestamp (std::chrono::time_point< std::chrono::system_clock, Duration > &out) const noexcept
	Parse this field as a std::chrono::system_clock time point.

template<typename T >
bool	operator== (T other) const noexcept
	Compares the contents of this field to a numeric value.

CONSTEXPR csv::string_view	get_sv () const noexcept
	Return a string view over the field's contents.

bool	is_null () const noexcept
	Returns true if field is an empty string or string of whitespace characters.

bool	is_str () const noexcept
	Returns true if field is a non-numeric, non-empty string.

bool	is_num () const noexcept
	Returns true if field is an integer or float.

bool	is_int () const noexcept
	Returns true if field is an integer.

bool	is_float () const noexcept
	Returns true if field is a floating point value.

bool	is_bool () const noexcept
	Returns true if field is a boolean value.

bool	is_timestamp () const noexcept
	Returns true if field is a timestamp value.

DataType	type () const noexcept
	Return the type of the underlying CSV data.

template<>
long double	get () const
	Retrieve this field's value as a long double.

template<>
CONSTEXPR bool	operator== (const char *other) const noexcept
	Compares the contents of this field to a string.

template<>
CONSTEXPR bool	operator== (csv::string_view other) const noexcept
	Compares the contents of this field to a string.

Detailed Description

Data type representing individual CSV values.

CSVFields can be obtained by using CSVRow::operator[]

Ordinary queries and conversions are logically const: they may populate a private lazy cache, but preserve the field's text and interpretation. Custom decimal parsing explicitly changes interpretation and is non-const.

Definition at line 74 of file csv_row.hpp.

Constructor & Destructor Documentation

◆ CSVField() [1/2]

constexpr csv::CSVField::CSVField ( csv::string_view _sv )

inlineexplicitconstexprnoexcept

Constructs a CSVField from a string_view.

Definition at line 77 of file csv_row.hpp.

◆ CSVField() [2/2]

csv::CSVField::CSVField	(	csv::string_view	_sv,
		const internals::CSVFieldScalar &	scalar
	)

inlinenoexcept

Definition at line 80 of file csv_row.hpp.

Member Function Documentation

◆ as()

template<typename T = std::string>

std::expected< T, CSVConversionError > csv::CSVField::as ( ) const

inline

Return this field as T, preserving conversion failure as CSVConversionError.

Returns: std::expected containing T on success, or CSVConversionError describing why conversion failed.

Note: Requires C++23 and a standard library that provides std::expected.

See also: CSVConversionError; csv_conversion_error_message()

Definition at line 162 of file csv_row.hpp.

◆ get() [1/2]

template<typename T = std::string>

T csv::CSVField::get ( ) const

inline

Returns the value casted to the requested type, performing type checking before.

Valid options for T

std::string or csv::string_view
signed integral types (signed char, short, int, long int, long long int)
unsigned integral types (unsigned char, unsigned short, unsigned int, unsigned long long)
floating point types (float, double, long double)

Invalid conversions

Converting non-numeric values to any numeric type
Converting floating point values to integers
Converting a large integer to a smaller type that will not hold it

Note: This method is capable of parsing scientific E-notation. See Scalar Conversion Reference for more details.

Exceptions

std::runtime_error Thrown if an invalid conversion is performed.

Warning: Currently, conversions to floating point types are not checked for loss of precision; Returned string views borrow the source text. Retain a row or field iterator for its parsing buffer, or request an owning std::string or numeric value.

Definition at line 140 of file csv_row.hpp.

◆ get() [2/2]

template<>

long double csv::CSVField::get ( ) const

inline

Retrieve this field's value as a long double.

Definition at line 892 of file csv_row.hpp.

◆ get_sv()

CONSTEXPR csv::string_view csv::CSVField::get_sv ( ) const

inlinenoexcept

Return a string view over the field's contents.

Definition at line 317 of file csv_row.hpp.

◆ is_bool()

bool csv::CSVField::is_bool ( ) const

inlinenoexcept

Returns true if field is a boolean value.

Definition at line 339 of file csv_row.hpp.

◆ is_float()

bool csv::CSVField::is_float ( ) const

inlinenoexcept

Returns true if field is a floating point value.

Definition at line 336 of file csv_row.hpp.

◆ is_int()

bool csv::CSVField::is_int ( ) const

inlinenoexcept

Returns true if field is an integer.

Definition at line 331 of file csv_row.hpp.

◆ is_null()

bool csv::CSVField::is_null ( ) const

inlinenoexcept

Returns true if field is an empty string or string of whitespace characters.

Definition at line 320 of file csv_row.hpp.

◆ is_num()

bool csv::CSVField::is_num ( ) const

inlinenoexcept

Returns true if field is an integer or float.

Definition at line 326 of file csv_row.hpp.

◆ is_str()

bool csv::CSVField::is_str ( ) const

inlinenoexcept

Returns true if field is a non-numeric, non-empty string.

Definition at line 323 of file csv_row.hpp.

◆ is_timestamp()

bool csv::CSVField::is_timestamp ( ) const

inlinenoexcept

Returns true if field is a timestamp value.

Definition at line 342 of file csv_row.hpp.

◆ operator csv::string_view()

csv::CSVField::operator csv::string_view ( ) const

inlinenoexcept

Definition at line 105 of file csv_row.hpp.

◆ operator std::optional< T >()

template<typename T >

csv::CSVField::operator std::optional< T > ( ) const

inline

Convert this field to std::optional<T>, returning std::nullopt when conversion fails.

This is a value-returning wrapper around try_get(), useful for C++17 callers that want non-throwing conversion without an output parameter.

Note: Requires C++17 or later.

Definition at line 212 of file csv_row.hpp.

◆ operator std::string()

csv::CSVField::operator std::string ( ) const

inline

Definition at line 109 of file csv_row.hpp.

◆ operator==() [1/3]

template<>

CONSTEXPR bool csv::CSVField::operator== ( const char * other ) const

noexcept

Compares the contents of this field to a string.

Definition at line 913 of file csv_row.hpp.

◆ operator==() [2/3]

template<>

CONSTEXPR bool csv::CSVField::operator== ( csv::string_view other ) const

noexcept

Compares the contents of this field to a string.

Definition at line 920 of file csv_row.hpp.

◆ operator==() [3/3]

template<typename T >

bool csv::CSVField::operator== ( T other ) const

inlinenoexcept

Compares the contents of this field to a numeric value.

If this field does not contain a numeric value, then all comparisons return false.

Note: Floating point values are considered equal if they are within 0.000001 of each other.

Warning: Multiple numeric comparisons involving the same field can be done more efficiently by calling the CSVField::get<>() method.

See also: csv::CSVField::operator==(const char * other); csv::CSVField::operator==(csv::string_view other)

Definition at line 303 of file csv_row.hpp.

◆ try_get() [1/2]

template<typename T = std::string>

bool csv::CSVField::try_get ( T & out ) const

inlinenoexcept

Non-throwing equivalent of get().

Applies the same type checks and conversions; returns true and writes to out on success, or returns false without throwing.

See also: get() for the full description of valid types, conversion rules, and warnings.

Example:

int value;
if (field.try_get(value)) {
    // Use value safely
} else {
    // Handle conversion failure
}

Definition at line 188 of file csv_row.hpp.

◆ try_get() [2/2]

template<typename T >

bool csv::CSVField::try_get	(	T &	out,
		CSVConversionError &	error
	)		const

inlinenoexcept

Convert with the same rules as try_get(), retaining the failure reason.

On failure, out is unchanged and error identifies the conversion failure.

Definition at line 197 of file csv_row.hpp.

◆ try_parse_decimal()

bool csv::CSVField::try_parse_decimal	(	long double &	dVal,
		const char	decimalSymbol = `'.'`
	)

Attempts to parse a decimal (or integer) value using the given symbol, returning true if the value is numeric.

Note: This method also updates this field's type

Definition at line 164 of file csv_row.cpp.

◆ try_parse_hex()

template<typename T = long long>

bool csv::CSVField::try_parse_hex ( T & parsedValue ) const

inline

Parse a hexadecimal value, returning false if the value is not hex.

Template Parameters

T	An integral type (int, long, long long, etc.)

Definition at line 222 of file csv_row.hpp.

◆ try_parse_timestamp() [1/3]

template<typename Rep , typename Period >

bool csv::CSVField::try_parse_timestamp ( std::chrono::duration< Rep, Period > & out ) const

inlinenoexcept

Parse this field as a timestamp duration since the Unix epoch.

Definition at line 267 of file csv_row.hpp.

◆ try_parse_timestamp() [2/3]

template<typename Duration >

bool csv::CSVField::try_parse_timestamp ( std::chrono::time_point< std::chrono::system_clock, Duration > & out ) const

inlinenoexcept

Parse this field as a std::chrono::system_clock time point.

Definition at line 279 of file csv_row.hpp.

◆ try_parse_timestamp() [3/3]

bool csv::CSVField::try_parse_timestamp ( std::uint64_t & out ) const

noexcept

Parse this field as Unix milliseconds.

Timestamp-classified values return their parsed epoch value. Integral values are treated as already being Unix milliseconds.

Definition at line 198 of file csv_row.cpp.

◆ type()

DataType csv::CSVField::type ( ) const

inlinenoexcept

Return the type of the underlying CSV data.

Definition at line 345 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

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ CSVField() [1/2]

◆ CSVField() [2/2]

Member Function Documentation

◆ as()

◆ get() [1/2]

◆ get() [2/2]

◆ get_sv()

◆ is_bool()

◆ is_float()

◆ is_int()

◆ is_null()

◆ is_num()

◆ is_str()

◆ is_timestamp()

◆ operator csv::string_view()

◆ operator std::optional< T >()

◆ operator std::string()

◆ operator==() [1/3]

◆ operator==() [2/3]

◆ operator==() [3/3]

◆ try_get() [1/2]

◆ try_get() [2/2]

◆ try_parse_decimal()

◆ try_parse_hex()

◆ try_parse_timestamp() [1/3]

◆ try_parse_timestamp() [2/3]

◆ try_parse_timestamp() [3/3]

◆ type()