company logo

Dictionary :: Dictionary - Create dictionary handle

The function allows creating a dictionary handle, which is either an empty dictionary handle or a copy for the dictionary handle passed to the function.

Implementation overview

Implementation details

  1. Create dictionary handle copy
    Dictionary  :: Dictionary ( odaba::Dictionary &cDictionary )

    This function creates a copy of the dictionary handle passed in cDictionary. Both, the copy and the origin are referring to the same access object. The access object is closed when closing the last dictionary handle instance referring to the dictionary (access object), regardless on the sequence the handles have been opened.

    • cDictionary - Dictionary handle

      The dictionary handle usually refers to an opened dictionary. Calling functions with invalid dictionary handles may cause an exception. For checking the dictionary handle, isValid() can be called.

  2. to list
  3. Create empty dictionary handle
    Dictionary  :: Dictionary (  )

    The function creates an empty dictionary handle. A dictionary can be opened later with this handle calling open(). The constructor will not open new dictionary handles, i.e. in order to open a dictionary handle, the open() function need to be called explicitly.

    Empty dictionary handles are not valid and may cause exceptions when calling Dictionary functions.

  4. to list