Qore DataProvider Module Reference 2.7.5
Loading...
Searching...
No Matches
DataProvider::HashDataType Class Reference

describes a data type based on a hash More...

#include <HashDataType.qc.dox.h>

Inheritance diagram for DataProvider::HashDataType:
[legend]

Public Member Methods

auto acceptsValue (auto input_value)
 Returns the value if the value can be assigned to the type. More...
 
HashDataType addField (AbstractDataField field)
 adds a field to the type
 
 constructor (string name=AutoHashType.getName(), *hash< auto > options, *hash< auto > tags)
 creates the object and assigns the name as the type
 
 constructor (string name=AutoHashType.getName(), hash< string, AbstractDataField > fields, *hash< auto > options, *hash< auto > tags)
 creates the object from the given record description and assigns the name as the type
 
 constructor (Type base_type, *string name, *hash< auto > options, *hash< auto > tags)
 creates the object and assigns the name as the given name or the base type's name
 
*AbstractDataProviderType getDefaultOtherFieldType ()
 Returns the default field type for undeclared fields, if any.
 
*AbstractDataField getField (string name)
 Returns the given field, if present, or NOTHING if not.
 
*hash< string, AbstractDataFieldgetFields ()
 Returns the fields of the data structure; if any.
 
hash< DataTypeInfogetInfo ()
 returns a description of the type as a hash
 
string getName ()
 Returns the type name.
 
AbstractDataProviderType getOrNothingType ()
 Returns an "or nothing" type equivalent to the current type. More...
 
AbstractDataProviderType getSoftType ()
 Returns a "soft" type equivalent to the current type. More...
 
bool hasDefaultOtherFieldType ()
 Returns True if the type has a default field type for undeclared fields.
 
bool isAssignableFrom (AbstractDataProviderType t)
 Returns True if this type can be assigned from values of the argument type. More...
 
 setDefaultOtherFieldType (*AbstractDataProviderType default_other_field_type)
 Sets the default field type for unlisted fields.
 
- Public Member Methods inherited from DataProvider::QoreDataType
auto acceptsValue (auto value)
 returns the value if the value can be assigned to the type More...
 
 constructor (Type type, *hash< auto > options, *hash< auto > tags)
 creates the type
 
hash< string, bool > getAcceptTypeHash ()
 returns a hash of base types accepted by this type; keys are type names
 
string getDesc ()
 Returns the description.
 
*hash< string, bool > getDirectTypeHash ()
 returns a hash of native base type code where no translations are performed; keys are type codes, not names
 
*AbstractDataProviderType getElementType ()
 returns the subtype (for lists or hashes) if there is only one
 
*hash< string, AbstractDataFieldgetFields ()
 returns the fields of the data structure; if any
 
hash< DataTypeInfogetInfo ()
 returns a description of the type as a hash
 
string getName ()
 returns the type name
 
AbstractDataProviderType getOrNothingType ()
 returns an "or nothing" type equivalent to the current type More...
 
hash< string, bool > getReturnTypeHash ()
 returns a hash of base types returned by this type; keys are type names
 
AbstractDataProviderType getSoftType ()
 returns a "soft" type equivalent to the current type More...
 
*hash< string, hash< DataProviderTypeOptionInfo > > getSupportedOptions ()
 returns supported options
 
*Type getValueType ()
 returns the base type for the type, if any
 
- Public Member Methods inherited from DataProvider::AbstractDataProviderType
abstract auto acceptsValue (auto value)
 Returns the value if the value can be assigned to the type. More...
 
 constructor ()
 creates the type
 
 constructor (hash< auto > options, *hash< auto > tags)
 creates the type and sets options More...
 
abstract hash< string, bool > getAcceptTypeHash ()
 Returns a hash of types accepted by this type; keys are type names.
 
int getBaseTypeCode ()
 Returns the base type code for the type.
 
string getBaseTypeName ()
 Returns the base type name for the type; must be a standard Qore base type name.
 
string getDesc ()
 Returns the description.
 
*hash< string, bool > getDirectTypeHash ()
 Returns a hash of native base type code keys where no translations are performed; keys are type codes, not names.
 
abstract *AbstractDataProviderType getElementType ()
 Returns the subtype (for lists or hashes) if there is only one.
 
*AbstractDataField getField (string field_name)
 Returns the given field, if present, or NOTHING if not.
 
*hash< string, hash< DataFieldInfo > > getFieldInfo ()
 Returns information on fields supported.
 
abstract *hash< string, AbstractDataFieldgetFields ()
 Returns the fields of the data structure; if any.
 
*AbstractDataProviderType getFieldType (string field_name)
 get the given field type if it exists, otherwise return NOTHING
 
hash< DataTypeInfogetInfo ()
 Returns a description of the type as a hash.
 
hash< DataTypeInfogetInputInfo ()
 Returns a description of the type as an input type. More...
 
abstract string getName ()
 Returns the type name.
 
*hash< auto > getOptions ()
 Returns options set on the type.
 
auto getOptionValue (string opt)
 Returns the value of the given option.
 
AbstractDataProviderType getOrNothingType ()
 Returns an "or nothing" type equivalent to the current type. More...
 
abstract hash< string, bool > getReturnTypeHash ()
 Returns a hash of types returned by this type; keys are type names.
 
AbstractDataProviderType getSoftType ()
 Returns a "soft" type equivalent to the current type. More...
 
*hash< string, hash< DataProviderTypeOptionInfo > > getSupportedOptions ()
 Returns supported options.
 
auto getTag (string tag)
 Returns the value of the given tag.
 
*hash< auto > getTags ()
 Returns tags set on the type.
 
abstract *Type getValueType ()
 Returns the base type for the type, if any.
 
bool hasType ()
 Returns True if the type is not a wildcard type.
 
bool isAssignableFrom (AbstractDataProviderType t)
 Returns True if this type can be assigned from values of the argument type.
 
bool isAssignableFrom (Type t)
 Returns True if this type can be assigned from values of the argument type.
 
bool isList ()
 Returns True if this type is a list.
 
bool isMandatory ()
 Returns True if the type must have a value.
 
bool isOrNothingType ()
 Returns True if the type also accepts NOTHING.
 
 setOption (string opt, auto value)
 sets the given option on the type More...
 
 setOptions (hash< auto > options)
 sets options on the type More...
 

Private Attributes

*AbstractDataProviderType default_other_field_type
 allow other fields
 
hash< string, AbstractDataFieldfields
 fields
 
bool has_default_other_field_type = False
 if the type requires validation
 
bool manual_default_other_field_type = False
 default other field type set mamnually?
 
string name
 the name of the type
 
- Private Attributes inherited from DataProvider::QoreDataType
*hash< string, bool > accept_type_hash
 hash of base types accepted by this type; keys are type names
 
hash< string, bool > base_type_hash
 hash of base types where no translations are performed; keys are type codes, not names More...
 
hash< string, bool > blacklist_type_hash
 hash of type codes accepted by the base type but not accepted by this type: code -> True
 
bool or_nothing_type
 flag for "or nothing" types
 
*hash< string, bool > return_type_hash
 hash of base types returned by this type; keys are type names
 
bool soft_type
 flag for soft types
 
const SoftTypeMap
 map from normal types to soft types
 
const SupportedOptions
 supported options
 
Type type
 the Qore type
 
- Private Attributes inherited from DataProvider::AbstractDataProviderType
hash< auto > options
 type options
 
*hash< auto > tags
 type tags
 

Additional Inherited Members

- Static Public Member Methods inherited from DataProvider::AbstractDataProviderType
static AbstractDataProviderType get (string typename, *hash< auto > options)
 Returns an appropriate object for the given type. More...
 
static AbstractDataProviderType get (Type type, *hash< auto > options, *hash< auto > tags)
 Returns an appropriate object for the given type.
 
- Public Attributes inherited from DataProvider::AbstractDataProviderType
const DefaultDesc = "no description available"
 Default description.
 
- Private Member Methods inherited from DataProvider::AbstractDataProviderType
 setOptionIntern (string opt, auto value)
 sets the given option without any validation of the option
 

Detailed Description

describes a data type based on a hash

Note
objects of this type are only compatible if their fields are compatible; non-matching fields of other types are automatically considered compatible; change the default "other field type" by calling setDefaultOtherFieldType() to change this; calling setDefaultOtherFieldType() with no argument removes compatibility with non-matching fields in other types.

Additionally, adding any fields before calling setDefaultOtherFieldType() will also remove compatibility with unknown fields

Member Function Documentation

◆ acceptsValue()

auto DataProvider::HashDataType::acceptsValue ( auto  input_value)
virtual

Returns the value if the value can be assigned to the type.

Parameters
input_valuethe value to assign to the type
Returns
the value to be assigned; can be converted by the type
Exceptions
RUNTIME-TYPE-ERRORvalue cannot be assigned to type

Implements DataProvider::AbstractDataProviderType.

◆ getOrNothingType()

AbstractDataProviderType DataProvider::HashDataType::getOrNothingType ( )

Returns an "or nothing" type equivalent to the current type.

Returns
an "or nothing" type equivalent to the current type

◆ getSoftType()

AbstractDataProviderType DataProvider::HashDataType::getSoftType ( )

Returns a "soft" type equivalent to the current type.

Returns
a "soft" type equivalent to the current type

◆ isAssignableFrom()

bool DataProvider::HashDataType::isAssignableFrom ( AbstractDataProviderType  t)

Returns True if this type can be assigned from values of the argument type.

Note
objects of this type are only compatible if their fields are compatible; if either side is a hash without declared fields, then they are compatible