tt_error(library call)                               tt_error(library call)




 NAME    [Toc]    [Back]
      tt_error - capture ToolTalk function errors

 SYNOPSIS    [Toc]    [Back]
      #include <Tt/tt_c.h>
      void tt_error(
      const char *funcname,
      Tt_status status);

 DESCRIPTION    [Toc]    [Back]
      The tt_error function is a publicly-known null function. It is called
      by the ToolTalk library just before it returns from any ToolTalk API
      call that has a status other than TT_OK.  The caller passes the name
      of the function that is about to return and the function's status
      code.

      You can use this function to set a dbx breakpoint to quickly catch and
      trace back any ToolTalk errors.  You can also interpose this function,
      for example, to log ToolTalk errors to stderr.

 ARGUMENTS    [Toc]    [Back]
      funcname  Specifies the name of the function.

      status    Specifies the function's return status value.

 RETURN VALUE    [Toc]    [Back]
      None.

 APPLICATION USAGE    [Toc]    [Back]
      The following code example shows how an application might interpose
      this function to log ToolTalk errors to stderr:

      void tt_error(const char *funcname, Tt_status status) {
              fprintf(stderr, "ToolTalk function %s returned %s.0,
                      funcname, tt_status_message(status));
      }

 SEE ALSO    [Toc]    [Back]
      Tt/tt_c.h - Tttt_c(5)


                                    - 1 -       Formatted:  January 24, 2005