DataSource :: dictionaryPath - DICTIONARY options
The dictionary path refers to the location of the application dictionary database. When referring to a dictionary or resource database as database, the system dictionary (ode.sys) has to be referred to as dictionary.
Paths can be defined as absolute or relative paths, or as reference path containing symbolic references (%sym_name%).
Usually, this value is set in the configuration or ini-file in the DICTIONARY option for the data source definition. In case of complex dictionary definition, one may, however, also define the database path in the PATH sub-option DICTIONARY.PATH.
; simple definition
DICTIONARY=C:/ODABA/Sample/Sample.dev
; complex definition
DICTIONARY=C:/ODABA/Sample/Sample.dev[
TYPE=ODABA
CONNECTION=Local]
The dictionary path refers to the location of the main dictionary file (root base).
In order to pass no dictionary path, an empty string ( String() ) has to be passed.
Implementation overview
- Get dictionary path
DataSource :: dictionaryPath ( ) - Set dictionary path
DataSource :: dictionaryPath ( sDictionaryPath )
Implementation details
-
Get dictionary path
odaba::String DataSource :: dictionaryPath ( )
The function returns the dictionary path set for the data source. When symbolic names have been used in the dictionary path (%sym_name%), the path with unresolved names is returned. In order to get the resolved dictionary path, call dictionary().path(), instead.
to list
-
Set dictionary path
odaba::String DataSource :: dictionaryPath ( odaba::String &sDictionaryPath )
The function allows changing the dictionary path for the data source. The function does not close the dictionary, when it is still open, i.e. dictionary handle and dictionary path might become inconsistent. In order to reopen the database with the new data base path, openDictionary() has to be called.
- sDictionaryPath
- File path to dictionary location
The dictionary path refers to the location of the main dictionary file (root base).
In order to pass no dictionary path, an empty string ( String() ) has to be passed.
to list
- sDictionaryPath
- File path to dictionary location