company logo

Client :: dataSourceName - Get data source name

A data catalog may be defined for an application by defining a data catalog section (DATA_CATALOG) for data catalog database in the ini- or configuration file.

The function provided data source names for data sources defined in the data catalog.

Return value:  Data source name ( odaba::String & )

The name of the data source refers to a section in a configuration or ini-file or to a data source defined in the data catalog defined for the application. Other data source variables are set from the data source definition referred to by the data source name.

Implementation details

odaba::String Client  :: dataSourceName ( int32 iPosition )

In order to read data source names from a data catalog opened by the main client, the function might be called with the position (iPosition) of the data source to be retrieved.

When no data catalog had been opened for the main client or when no data source is available at the position passed, the function throws an exception.

  • iPosition - Position in collection

    The position of an element in a collection is beginning with 0 for the first element.