dwww Home | Manual pages | Find package

ZMQ_ATOMIC_COUNTER_V(3)           0MQ Manual           ZMQ_ATOMIC_COUNTER_V(3)

NAME
       zmq_atomic_counter_value - return value of atomic counter

SYNOPSIS
       int zmq_atomic_counter_value (void *counter);

DESCRIPTION
       The zmq_atomic_counter_value function returns the value of an atomic
       counter created by zmq_atomic_counter_new(). This function uses
       platform specific atomic operations.

RETURN VALUE
       The zmq_atomic_counter_value() function returns the value of the atomic
       counter. If counter does not point to an atomic counter created by
       zmq_atomic_counter_new(), the behaviour is undefined.

EXAMPLE
       Test code for atomic counters.

           void *counter = zmq_atomic_counter_new ();
           assert (zmq_atomic_counter_value (counter) == 0);
           assert (zmq_atomic_counter_inc (counter) == 0);
           assert (zmq_atomic_counter_inc (counter) == 1);
           assert (zmq_atomic_counter_inc (counter) == 2);
           assert (zmq_atomic_counter_value (counter) == 3);
           assert (zmq_atomic_counter_dec (counter) == 1);
           assert (zmq_atomic_counter_dec (counter) == 1);
           assert (zmq_atomic_counter_dec (counter) == 0);
           zmq_atomic_counter_set (counter, 2);
           assert (zmq_atomic_counter_dec (counter) == 1);
           assert (zmq_atomic_counter_dec (counter) == 0);
           zmq_atomic_counter_destroy (&counter);
           return 0;

SEE ALSO
       zmq_atomic_counter_new(3) zmq_atomic_counter_set(3)
       zmq_atomic_counter_inc(3) zmq_atomic_counter_dec(3)
       zmq_atomic_counter_destroy(3)

AUTHORS
       This page was written by the 0MQ community. To make a change please
       read the 0MQ Contribution Policy at
       http://www.zeromq.org/docs:contributing.

0MQ 4.3.4                         01/18/2023           ZMQ_ATOMIC_COUNTER_V(3)

Generated by dwww version 1.15 on Sat Jun 29 11:41:10 CEST 2024.