tt_feature_enabled(3)

NAME

tt_feature_enabled - Query the ToolTalk library to see if a particular feature has been enabled previously

SYNOPSIS

#include <Tt/tt_c.h>
Tt_status tt_feature_enabled ( Tt_feature feature );

DESCRIPTION

The tt_feature_enabled() call queries the ToolTalk service to see if the indicated feature has previously been enabled.

The feature argument is a value indicating a particular feature in which the calling code is interested.

RETURN VALUE

Upon successful completion, the tt_feature_enabled() function returns the status of the operation as one of the following Tt_status values:

TT_OK The operation completed successfully.

TT_WRN_NOT_ENABLED
The feature has not yet been enabled.

TT_ERR_UNIMP
The version of the ToolTalk library linked with the calling code does not support the indicated feature.

APPLICATION USAGE

A library using ToolTalk could check to see if the calling application had previously turned on ToolTalk’s multithreading feature with the following code:

Tt_status ttstat;
ttstat = tt_feature_enabled(TT_FEATURE_MULTITHREADED);
if (ttstat != TT_OK) {
ttstat = tt_feature_required(TT_FEATURE_MULTITHREADED);
}

Museum