validators::VectorValidator< T > Class Template Reference

Chainable validator for vector TOML fields. More...

#include <config_validators.hpp>

Public Member Functions
	VectorValidator (const toml::table &config_, const std::string &key_)
VectorValidator &	minLength (size_t min_len_)
	Requires minimum vector length.
VectorValidator &	positive ()
	Requires all vector elements to be strictly positive (> 0).
VectorValidator &	hasLength (size_t exact_len_)
	Requires vector to have exactly the specified length.
std::vector< T >	value ()
	Extracts and validates the vector field.
std::vector< T >	valueOr (const std::vector< T > &default_value_)
	Extracts vector or returns default if missing.

Detailed Description

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

Chainable validator for vector TOML fields.

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

Available Validation Methods

• minLength(size): Vector must have at least size elements
• hasLength(size): Vector must have exactly size elements
• positive(): All elements must be > 0 (only for numeric types)

Extraction Methods

• value(): Extract validated array (throws if field missing or invalid)
• valueOr(default): Extract array or return default if field missing

Type Requirements

The element type T must be a type supported by the TOML library (int, double, string, bool). For numeric types, you can use the positive() validation. For other types, only array-level validations (length) are available.

Template Parameters

T	Element type of the vector (int, double, string, bool, etc.)

Constructor & Destructor Documentation

VectorValidator()

template<typename T >

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

inline

Member Function Documentation

hasLength()

template<typename T >

VectorValidator & validators::VectorValidator< T >::hasLength ( size_t  exact_len_ )

inline

Requires vector to have exactly the specified length.

Parameters

exact_len_

Exact number of elements required

Returns

Reference to this validator for chaining

minLength()

template<typename T >

VectorValidator & validators::VectorValidator< T >::minLength ( size_t  min_len_ )

inline

Requires minimum vector length.

Parameters

min_len_

Minimum number of elements (inclusive)

Returns

Reference to this validator for chaining

positive()

template<typename T >

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

inline

Requires all vector elements to be strictly positive (> 0).

Returns

Reference to this validator for chaining

value()

template<typename T >

std::vector< T > validators::VectorValidator< T >::value ( )

inline

Extracts and validates the vector field.

Returns

The validated vector

Exceptions

ValidationError

If validation fails

valueOr()

template<typename T >

std::vector< T > validators::VectorValidator< T >::valueOr ( const std::vector< T > &  default_value_ )

inline

Extracts vector or returns default if missing.

Parameters

default_value_

Default vector to use if field is missing

Returns

The field vector 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