company logo

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]

Return value:  File path to dictionary location ( odaba::String & )

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

Implementation details

  1. 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.

  2. to list
  3. 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.

  4. to list