tt_objid_equal - test whether two objids are equal
#include <Tt/tt_c.h> int tt_objid_equal(const char *objid1, const char *objid2);
tt_objid_equal(3) ToolTalk Functions tt_objid_equal(3)
NAME
tt_objid_equal - test whether two objids are equal
SYNOPSIS
#include <Tt/tt_c.h>
int tt_objid_equal(const char *objid1,
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 val-
ues 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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
SEE ALSO
tt_c(5), tt_int_error(3).
ToolTalk 1.3 1 March 1996 tt_objid_equal(3)