Standard C Library Functions                       atomicdec(3C)



NAME
     atomicdec, atomicdec8,  atomicdecuchar,  atomicdec16,
     atomicdecushort,      atomicdec32,      atomicdecuint,
     atomicdeculong,       atomicdec64,       atomicdecptr,
     atomicdec8nv,    atomicdecucharnv,   atomicdec16nv,
     atomicdecushortnv, atomicdec32nv,  atomicdecuintnv,
     atomicdeculongnv,  atomicdec64nv,  atomicdecptrnv -
     atomic decrement operations

SYNOPSIS
     #include 

     void atomicdec8(volatile uint8t *target);


     void atomicdecuchar(volatile uchart *target);


     void atomicdec16(volatile uint16t *target);


     void atomicdecushort(volatile ushortt *target);


     void atomicdec32(volatile uint32t *target);


     void atomicdecuint(volatile uintt *target);


     void atomicdeculong(volatile ulongt *target);


     void atomicdec64(volatile uint64t *target);


     void atomicdecptr(volatile void *target);


     uint8t atomicdec8nv(volatile uint8t *target);


     uchart atomicdecucharnv(volatile uchart *target);


     uint16t atomicdec16nv(volatile uint16t *target);


     ushortt atomicdecushortnv(volatile ushortt *target);






SunOS 5.11          Last change: 13 May 2005                    1






Standard C Library Functions                       atomicdec(3C)



     uint32t atomicdec32nv(volatile uint32t *target);


     uintt atomicdecuintnv(volatile uintt *target);


     ulongt atomicdeculongnv(volatile ulongt *target);


     uint64t atomicdec64nv(volatile uint64t *target);


     void *atomicdecptrnv(volatile void *target);


DESCRIPTION
     These functions enable the  decrementing  (by  one)  of  the
     value stored in target to occur in an atomic manner.

RETURN VALUES
     The *nv() variants of these functions return the new  value
     of target.

ERORS
     No errors are defined.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Stable                      
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     atomicadd(3C),       atomicand(3C),       atomicbits(3C),
     atomiccas(3C),        atomicinc(3C),        atomicor(3C),
     atomicswap(3C),       membarops(3C),        attributes(5),
     atomicops(9F)

NOTES
     The *nv() variants are substantially more expensive on some
     platforms  than  the  versions that do not return values. Do
     not use them unless you need to know the  new  value  atomi-
     cally  (for example, when decrementing a reference count and



SunOS 5.11          Last change: 13 May 2005                    2






Standard C Library Functions                       atomicdec(3C)



     checking whether it went to zero).






















































SunOS 5.11          Last change: 13 May 2005                    3