Index Click this button to go to the index for this section.


tt_default_file(3)

CDE

NAME

tt_default_file - return the current default file

SYNOPSIS

#include <Tt/tt_c.h> char *tt_default_file(void);

DESCRIPTION

The tt_default_file function returns the current default file. When the application joins a file, the file becomes the default.

RETURN VALUE

Upon successful completion, the tt_default_file function returns the pointer to a character string that specifies the current default file. If the pointer is NULL, no default file is set. The application can use tt_ptr_error3 to extract one of the following Tt_status values from the returned pointer: The operation completed successfully. The ttsession1 process is not running and the ToolTalk service cannot restart it. The current default process identifier is out of date or invalid.

APPLICATION USAGE

The application should use tt_free3 to free any data stored in the address returned by the ToolTalk API.

SEE ALSO

Tt/tt_c.h5, tt_file_join3, tt_default_file_set3, tt_ptr_error3, tt_free3.