validators::Validator< T > Class Template Reference

Chainable validator for scalar TOML fields. More...

#include <config_validators.hpp>

Public Member Functions
	Validator (const toml::table &config_, const std::string &key_)
Validator &	greaterThan (T greater_than_)
	Requires value to be strictly greater than threshold.
Validator &	greaterThanEqual (T greater_than_equal_)
	Requires value to be greater than or equal to threshold.
Validator &	lessThan (T less_than_)
	Requires value to be strictly less than threshold.
Validator &	positive ()
	Requires value to be strictly positive (> 0).
T	value ()
	Extracts and validates the field value.
T	valueOr (T default_value_)
	Extracts field value or returns default if missing.

Detailed Description

template<typename T>
class validators::Validator< T >

Chainable validator for scalar TOML fields.

This class provides type-safe extraction and validation of single-value fields from TOML configuration using the method chaining pattern described above.

Available Validation Methods

If any of the following methods are called, the corresponding validation is applied when extracting the value, and an error is thrown if the validation fails.

• greaterThan(value): Field must be > value
• greaterThanEqual(value): Field must be >= value
• lessThan(value): Field must be < value
• positive(): Field must be > 0 (shorthand for greaterThan(0))

Extraction Methods

• value(): Extract scalar or throws an error if field is missing or invalid
• valueOr(default): Extract scalar or return default if field missing

Template Parameters

T	Type of field to validate (int, double, string, bool, etc.)

Constructor & Destructor Documentation

Validator()

template<typename T >

validators::Validator< T >::Validator ( const toml::table &  config_, const std::string &  key_  )

inline

Member Function Documentation

greaterThan()

template<typename T >

Validator & validators::Validator< T >::greaterThan ( T  greater_than_ )

inline

Requires value to be strictly greater than threshold.

Parameters

greater_than_

Threshold value (exclusive)

Returns

Reference to this validator for chaining

greaterThanEqual()

template<typename T >

Validator & validators::Validator< T >::greaterThanEqual ( T  greater_than_equal_ )

inline

Requires value to be greater than or equal to threshold.

Parameters

greater_than_equal_

Threshold value (inclusive)

Returns

Reference to this validator for chaining

lessThan()

template<typename T >

Validator & validators::Validator< T >::lessThan ( T  less_than_ )

inline

Requires value to be strictly less than threshold.

Parameters

less_than_

Threshold value (exclusive)

Returns

Reference to this validator for chaining

positive()

template<typename T >

Validator & validators::Validator< T >::positive ( )

inline

Requires value to be strictly positive (> 0).

Returns

Reference to this validator for chaining

value()

template<typename T >

T validators::Validator< T >::value ( )

inline

Extracts and validates the field value.

Throws ValidationError if the field is missing or if any validation rules fail.

Returns

The validated field value

Exceptions

ValidationError

If validation fails

valueOr()

template<typename T >

T validators::Validator< T >::valueOr ( T  default_value_ )

inline

Extracts field value or returns default if missing.

If the field is present, validates it (may throw). If absent, returns the provided default without validation.

Parameters

default_value_

Default value to use if field is missing

Returns

The field value or default

Exceptions

ValidationError

If field exists but validation fails

---

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

• /home/runner/work/quandary/quandary/include/config_validators.hpp