company logo

DataSource :: objectSpaceName - OBJECT_SPACE option

In many cases, a database consists only of the root object space and no object space must be defined.

In some cases the database is, however, build of a number of hierarchical object spaces where each object space may contain a whole universe of object instances. Object spaces are referenced in the defined hierarchy. In order to access a subordinated object space, a path to the object space must be defined in the data source.

The root object space did not get a name, i.e. object space names begin with the first subordinated object space.

Usually, this value is set in the configuration or ini-file in the OBJECT_SPACE option for the data source definition.

OBJECT_SPACE=myClient.subClient

Return value:  Object space name ( odaba::String & )

Names can be assigned to object spaces in order to access an object space via name.

Usually, however, no names are assigned to object spaces. In order to pass no object space name, an empty string ( String() ) has to be passed.

Implementation overview

Implementation details

  1. Get object space path
    odaba::String DataSource  :: objectSpaceName (  )

    The function returns the object space path as being defined for the data source.

  2. to list
  3. Set path to object space
    odaba::String DataSource  :: objectSpaceName ( odaba::String &sObjectSpaceName )

    The function allows setting the object space path for the data source. The function does not close the or reopen the object space automatically, i.e. the path should be set before opening the data source or the object space must opened ( open() ) by the application.

    • sObjectSpaceName - Object space name

      Names can be assigned to object spaces in order to access an object space via name.

      Usually, however, no names are assigned to object spaces. In order to pass no object space name, an empty string ( String() ) has to be passed.

  4. to list