Index for Section 3

Alphabetical listing for T

Bottom of page

tt_objid_equal(3)
CDE
NAME
  tt_objid_equal - test whether two objids are equal

SYNOPSIS
  #include <tt_c.h>
  int tt_objid_equal(const char *objid,
		     const char *objid2);

DESCRIPTION
  The tt_objid_equal function tests whether two objids are equal.

  The tt_objid_equal(3) function is recommended rather than strcmp(3) for
  this purpose because the tt_objid_equal(3) function returns 1 even in the
  case where one objid is a forwarding pointer for the other.

  The objid1 argument is the identifier of the first object involved in this
  operation. The objid2 argument is the identifier of the second object
  involved in this operation.

RETURN VALUE
  Upon successful completion, the tt_objid_equal function returns an integer
  that indicates whether the objids are equal. The application can use
  tt_int_error(3) to extract one of the following Tt_status values from the
  returned integer:

  0   The objid1 and objid2 objects are not equal.

  1   The objid1 and objid2 objects are equal.

  The application can use tt_int_error(3) to determine if the integer is
  valid. The tt_objid_equal function returns one of the following Tt_status
  values:

  TT_OK
      The operation completed successfully.

  TT_ERR_NOMP
      The ttsession(1) process is not running and the ToolTalk service cannot
      restart it.

  TT_ERR_OBJID
      The objid passed to the ToolTalk service does not reference an existing
      object spec.

SEE ALSO
  tt_c.h(5), tt_int_error(3)

Index for Section 3

Alphabetical listing for T

Top of page