SYNOPSIS

       C or C++:

          #include <mpp/shmem.h>

          int shmem_int_finc(int *target, int pe)

          long shmem_long_finc(long *target, int pe)

          long long shmem_longlong_finc(long long *target, int pe)

       Fortran:

          INCLUDE "mpp/shmem.fh"

          INTEGER pe
          INTEGER(KIND=4) SHMEM_INT4_FINC, target4
          INTEGER(KIND=8) SHMEM_INT8_FINC, target8

          ires4 = SHMEM_INT4_FINC(target4, pe)

          ires8 = SHMEM_INT8_FINC(target8, pe)

DESCRIPTION

       The  fetch  and  increment routines retrieve the value at address target on PE pe, and update target with
       the result of incrementing the retrieved value by one.  The  operation  must  be  completed  without  the
       possibility of another process updating target between the time of the fetch and the update.

       The arguments are as follows:

       target The  remotely  accessible  integer  data object to be updated on the remote PE. The type of target
              should match that implied in the SYNOPSIS section.

       pe     An integer that indicates the PE number upon which target is to  be  updated.  If  you  are  using
              Fortran, it must be a default integer value.

NOTES

       The term remotely accessible is defined in intro_shmem(3).

RETURN VALUES

       The contents that had been at the target address on the remote PE prior to the increment.

       SEE ALSO:
          intro_shmem(3)

COPYRIGHT

       2003-2025, The Open MPI Community

                                                  Feb 17, 2025                                 SHMEM_INT_FINC(3)