Parsnip::ListSchema Class Reference

Schema component for lists. More...

#include <parsnip_schema.h>

Inheritance diagram for Parsnip::ListSchema:

Collaboration diagram for Parsnip::ListSchema:

Public Types
using	size_type = Data::ListType::size_type

Public Member Functions
	ListSchema ()=default
	ListSchema (const ListSchema &from)=default
	ListSchema (ListSchema &&)=default
ListSchema &	operator= (const ListSchema &from)=default
ListSchema &	operator= (ListSchema &&)=default
	ListSchema (SchemaBaseRef &&, size_type minimum=0, size_type maximum=std::numeric_limits< size_type >::max())
	Construct a list schema (move variant). More...
	ListSchema (const SchemaBase &, size_type minimum=0, size_type maximum=std::numeric_limits< size_type >::max())
	Construct a list schema (cppy variant). More...
	ListSchema (const Parsnip::Data &schema_spec)
	Construct a list schema from a schema specification. More...
virtual ListSchema *	createCopy () const override
	Create an identical, deep copy of the schema. More...
virtual void	validate (const Parsnip::Data &entry) const override
	Validate a list: ensure all elements conform to a single schema. More...
virtual bool	operator== (const SchemaBase &other) const override
	Check if two schemas perform the same validation. More...
virtual void	mergeSchemas (const SchemaBase &from) override
	Merge elements into the current schema. More...
virtual std::ostream &	dump (std::ostream &target, int indent, bool suppress_ident=false) const override
	Render the schema in human-friendly text. More...
Public Member Functions inherited from Parsnip::SchemaBase
virtual	~SchemaBase ()=default
bool	operator!= (const SchemaBase &other) const

Private Attributes
SchemaBaseRef	member_schema
size_type	minimum_required = 0
size_type	maximum_allowed = std::numeric_limits<int>::max()
bool	single_as_nonlist_allowed = false

Additional Inherited Members
Protected Types inherited from Parsnip::SchemaBase
using	StringType = Data::StringType
using	SchemaRegex = std::basic_regex< StringType::value_type >
Protected Member Functions inherited from Parsnip::SchemaBase
	SchemaBase ()=default
	SchemaBase (const SchemaBase &)=default
	SchemaBase (SchemaBase &&)=default
SchemaBase &	operator= (const SchemaBase &)=default
SchemaBase &	operator= (SchemaBase &&)=default
	SchemaBase (const Parsnip::Data &schema_spec)
	Construct a schema from a JSON specification. More...
void	checkType (Data::Type expected, const Parsnip::Data &entry) const
	Check that Data item is an allowed type. More...
bool	isValidlyNull (const Parsnip::Data &entry) const
	Determine if the data is Null and if that is allowed. More...
bool	isType (Data::Type expected, const Parsnip::Data &entry) const
	Check if a data object is a particular type. More...
Protected Attributes inherited from Parsnip::SchemaBase
bool	nullable = false
	If true, element may be null. More...

Detailed Description

Schema component for lists.

Note this expects list members to all be uniform element type.

Member Typedef Documentation

size_type

using Parsnip::ListSchema::size_type = Data::ListType::size_type

Constructor & Destructor Documentation

ListSchema() [1/6]

Parsnip::ListSchema::ListSchema ( )

default

Here is the caller graph for this function:

ListSchema() [2/6]

Parsnip::ListSchema::ListSchema ( const ListSchema &  from )

default

ListSchema() [3/6]

Parsnip::ListSchema::ListSchema ( ListSchema &&  )

default

ListSchema() [4/6]

Parsnip::ListSchema::ListSchema	(	SchemaBaseRef &&	from,
		size_type	minimum = 0,
		size_type	maximum = std::numeric_limits<size_type>::max()
	)

Construct a list schema (move variant).

Parameters

from	A schema to validate the list members.
minimum	The number of list members mandated.
maximum	The number of list members allowed.

ListSchema() [5/6]

Parsnip::ListSchema::ListSchema	(	const SchemaBase &	member_schema,
		size_type	minimum = 0,
		size_type	maximum = std::numeric_limits<size_type>::max()
	)

Construct a list schema (cppy variant).

Parameters

member_schema	A schema to validate the list members.
minimum	The number of list members mandated.
maximum	The number of list members allowed.

ListSchema() [6/6]

Parsnip::ListSchema::ListSchema

(

const Parsnip::Data &

schema_spec

)

Construct a list schema from a schema specification.

Do nothing.

Here is the call graph for this function:

Member Function Documentation

createCopy()

ListSchema * Parsnip::ListSchema::createCopy ( ) const

overridevirtual

Create an identical, deep copy of the schema.

Caller is responsible for deleting it.

Implements Parsnip::SchemaBase.

Here is the call graph for this function:

dump()

std::ostream & Parsnip::ListSchema::dump ( std::ostream &  target, int  indent, bool  suppress_indent = false  ) const

overridevirtual

Render the schema in human-friendly text.

Parameters

target	Where to write the schema.
indent	Amount of indent to use.
suppress_indent	Flag indicating indent was already performed.

Implements Parsnip::SchemaBase.

Here is the call graph for this function:

mergeSchemas()

void Parsnip::ListSchema::mergeSchemas ( const SchemaBase &  from )

overridevirtual

Merge elements into the current schema.

Merge elements managed by this class.

• Elements seen every time are mandatory.
• Elements seen only sometime are optional.
• Elements always seen together are codependent.
• Elements must always expect similar types, except they may vary as element and list-of-same-element.

  Parameters

  from	A schema for a valid command command line.

  Exceptions

  Various

  exceptions.

Reimplemented from Parsnip::SchemaBase.

operator=() [1/2]

ListSchema& Parsnip::ListSchema::operator= ( const ListSchema &  from )

default

operator=() [2/2]

ListSchema& Parsnip::ListSchema::operator= ( ListSchema &&  )

default

operator==()

bool Parsnip::ListSchema::operator== ( const SchemaBase &  other ) const

overridevirtual

Check if two schemas perform the same validation.

Compare two schemas to see if they determine validity in the same manner.

Parameters

other

The schema to compare to.

Returns

True if the schemas match, false otherwise.

Reimplemented from Parsnip::SchemaBase.

validate()

void Parsnip::ListSchema::validate ( const Parsnip::Data &  entry ) const

overridevirtual

Validate a list: ensure all elements conform to a single schema.

Implements Parsnip::SchemaBase.

Here is the call graph for this function:

Member Data Documentation

maximum_allowed

size_type Parsnip::ListSchema::maximum_allowed = std::numeric_limits<int>::max()

private

member_schema

SchemaBaseRef Parsnip::ListSchema::member_schema

private

minimum_required

size_type Parsnip::ListSchema::minimum_required = 0

private

single_as_nonlist_allowed

bool Parsnip::ListSchema::single_as_nonlist_allowed = false

private

---

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

• parsnip/parsnip_schema.h
• parsnip/parsnip_schema.cpp