Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

tt_message_abstainers_count (3)

Name

tt_message_abstainers_count - return a count of the offer's abstaining procids

Synopsis

#include <Tt/tt_c.h>
int tt_message_abstainers_count(Tt_message m);

Description

ToolTalk Functions                              tt_message_abstainers_count(3)



NAME
       tt_message_abstainers_count  - return a count of the offer's abstaining
       procids

SYNOPSIS
       #include <Tt/tt_c.h>
       int tt_message_abstainers_count(Tt_message m);

DESCRIPTION
       The tt_message_abstainers_count() function returns a count of the  pro-
       cids that are recorded in the offer m as having abstained from it.

       The  m  argument  is the opaque handle for the message involved in this
       operation.

RETURN VALUE
       Upon successful completion, the tt_message_abstainers_count()  function
       returns a count of the procids that are recorded in the offer m as hav-
       ing abstained from it.  The  application  can  use  tt_int_error(3)  to
       extract  one  of the following Tt_status values from the returned inte-
       ger:

          TT_OK   The operation completed successfully.

          TT_ERR_PROCID
                  There is no valid default procid, perhaps because tt_open(3)
                  has not yet been called.

          TT_ERR_STATE
                  The  specified  message  is not in state TT_RETURNED.  Since
                  only TT_OFFERs can be in state TT_RETURNED, this status will
                  be  returned  if  the  specified message is a TT_NOTICE or a
                  TT_REQUEST.

          TT_ERR_POINTER
                  The pointer passed does not point to an object of  the  cor-
                  rect type for this operation.

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_message_abstainer(3), tt_int_error(3).




ToolTalk 1.3                     1 March 1996
                                                tt_message_abstainers_count(3)