Parsnip::KeywordSchema Class Reference

Schema component accepting strings with certain values. More...

#include <parsnip_schema.h>

Inheritance diagram for Parsnip::KeywordSchema:

Collaboration diagram for Parsnip::KeywordSchema:

Public Member Functions
	KeywordSchema ()=default
	KeywordSchema (const KeywordSchema &)=default
	KeywordSchema (KeywordSchema &&)=default
KeywordSchema &	operator= (const KeywordSchema &)=default
KeywordSchema &	operator= (KeywordSchema &&)=default
	KeywordSchema (const std::string &word)
	Construct a keyword schema, starting with one initial keyword. More...
	KeywordSchema (const Parsnip::Data &schema_spec)
	Construct a keyword (string enumeration) schema from a specification. More...
virtual KeywordSchema *	createCopy () const override
	Create an identical, deep copy of the schema. More...
void	addKeyword (const std::string &word)
	Add an additional keyword that the schema will allow. More...
virtual void	validate (const Parsnip::Data &entry) const override
	Validate a Keyword: ensure the datatype is a string, and that it matches one of the allowed values. 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
std::set< StringType >	valid_values
bool	ignore_case = true

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 accepting strings with certain values.

Constructor & Destructor Documentation

KeywordSchema() [1/5]

Parsnip::KeywordSchema::KeywordSchema ( )

default

KeywordSchema() [2/5]

Parsnip::KeywordSchema::KeywordSchema ( const KeywordSchema &  )

default

KeywordSchema() [3/5]

Parsnip::KeywordSchema::KeywordSchema ( KeywordSchema &&  )

default

KeywordSchema() [4/5]

Parsnip::KeywordSchema::KeywordSchema

(

const std::string &

word

)

Construct a keyword schema, starting with one initial keyword.

KeywordSchema() [5/5]

Parsnip::KeywordSchema::KeywordSchema

(

const Parsnip::Data &

schema_spec

)

Construct a keyword (string enumeration) schema from a specification.

Here is the call graph for this function:

Member Function Documentation

addKeyword()

void Parsnip::KeywordSchema::addKeyword

(

const std::string &

word

)

Add an additional keyword that the schema will allow.

Parameters

word	The keyword to allow.

createCopy()

KeywordSchema * Parsnip::KeywordSchema::createCopy ( ) const

overridevirtual

Create an identical, deep copy of the schema.

Caller is responsible for deleting it.

Implements Parsnip::SchemaBase.

dump()

std::ostream & Parsnip::KeywordSchema::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::KeywordSchema::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.

Here is the call graph for this function:

operator=() [1/2]

KeywordSchema& Parsnip::KeywordSchema::operator= ( const KeywordSchema &  )

default

operator=() [2/2]

KeywordSchema& Parsnip::KeywordSchema::operator= ( KeywordSchema &&  )

default

operator==()

bool Parsnip::KeywordSchema::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.

Here is the call graph for this function:

validate()

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

overridevirtual

Validate a Keyword: ensure the datatype is a string, and that it matches one of the allowed values.

Implements Parsnip::SchemaBase.

Here is the call graph for this function:

Member Data Documentation

ignore_case

bool Parsnip::KeywordSchema::ignore_case = true

private

valid_values

std::set<StringType> Parsnip::KeywordSchema::valid_values

private

---

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

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