DataProvider::AbstractDataProviderType Class Referenceabstract

describes a data type More...

Inheritance diagram for DataProvider::AbstractDataProviderType:
[legend]

## Public Member Functions

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)
| 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.
*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, AbstractDataField > | getFields ()
| 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< DataTypeInfo > | getInfo ()
| Returns a description of the type as a hash.
hash< DataTypeInfo > | getInputInfo ()
| 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.
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...

## Static Public Member Functions

static AbstractDataProviderType | get (Type type, *hash< auto > options)
| Returns an appropriate object for the given type.
static AbstractDataProviderType | get (string typename, *hash< auto > options)
| Returns an appropriate object for the given type. More...

## Protected Member Functions

| setOptionIntern (string opt, auto value)
| sets the given option without any validation of the option

## Protected Attributes

hash< auto > | options
| type options

## Detailed Description

describes a data type

## Member Function Documentation

## acceptsValue()

abstract auto DataProvider::AbstractDataProviderType::acceptsValue | ( | auto | value | ) |

pure virtual

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

Parameters

  value | the value to assign to the type

Returns
  the value to be assigned; can be converted by the type

Implemented in DataProvider::QoreDataType, DataProvider::ListDataType, DataProvider::HashDataType, DataProvider::QoreDateDataTypeBase, DataProvider::QoreStringDataTypeBase, DataProvider::HashDeclDataType, DataProvider::QoreFloatDataTypeBase, DataProvider::QoreIntDataTypeBase, DataProvider::QoreNumberDataTypeBase, DataProvider::QoreBoolDataTypeBase, and DataProvider::QoreBinaryDataTypeBase.

## constructor()

DataProvider::AbstractDataProviderType::constructor | ( | hash< auto > | options | ) |

creates the type and sets options

Parameters

  options | a hash of options, if any options match supported options for this type, they are set

Exceptions

  TYPE-OPTION-ERROR | option value has an invalid type

## get()

static AbstractDataProviderType DataProvider::AbstractDataProviderType::get | ( | string | typename,
|  | *hash< auto > | options
| ) |  |

static

Returns an appropriate object for the given type.

Parameters

  typename | the name of the type; should be a valid Qore type string
  options | type options for the data type object

## getInputInfo()

hash<DataTypeInfo> DataProvider::AbstractDataProviderType::getInputInfo | ( |  | ) |

Returns a description of the type as an input type.

Returns
  a description of the type as an input type; only the following keys are returned
  - `name`
  - `types_returned`

## getOrNothingType()

AbstractDataProviderType DataProvider::AbstractDataProviderType::getOrNothingType | ( |  | ) |

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

The base class method returns the same type; this method must be overridden in child classes to return a usable "or nothing" type

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

Note
  recursively updates fields to "or nothing" types as well

## getSoftType()

AbstractDataProviderType DataProvider::AbstractDataProviderType::getSoftType | ( |  | ) |

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

The base class method returns the same type; this method must be overridden in child classes to return a usable "soft" type

Returns
  a "soft" type equivalent to the current type

## setOption()

DataProvider::AbstractDataProviderType::setOption | ( | string | opt,
|  | auto | value
| ) |  |

sets the given option on the type

Parameters

  opt | the option to set
  value | the value to set

Exceptions

  TYPE-OPTION-ERROR | invalid option or invalid option type

## setOptions()

DataProvider::AbstractDataProviderType::setOptions | ( | hash< auto > | options | ) |

sets options on the type

Parameters

  options | the options to set; unsupported options are ignored

Exceptions

  TYPE-OPTION-ERROR | invalid option type