company logo

Dictionary :: assign - Create dictionary handle copy

The function creates a copy of a dictionary handle. The function is called in OSI or C++ functions when assigning dictionaries by using the operator=.

Return value:  Dictionary handle ( odaba::Dictionary & )

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.

Implementation details

odaba::Dictionary & Dictionary  :: assign ( 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.