SYNTAX
------

C Syntax
^^^^^^^^

.. code-block:: c

    int MPI_Cart_map(MPI_Comm comm, int ndims, const int dims[], const
        int periods[], int* newrank)

Fortran Syntax
^^^^^^^^^^^^^^

.. code-block:: fortran

    USE MPI
    ! or the older form: INCLUDE 'mpif.h'
    MPI_CART_MAP(COMM, NDIMS, DIMS, PERIODS, NEWRANK, IERROR)
    	INTEGER COMM, NDIMS, DIMS(*), NEWRANK, IERROR
    	LOGICAL PERIODS(*)

Fortran 2008 Syntax
^^^^^^^^^^^^^^^^^^^

.. code-block:: fortran

    USE mpi_f08
    MPI_Cart_map(comm, ndims, dims, periods, newrank, ierror)
    	TYPE(MPI_Comm), INTENT(IN) :: comm
    	INTEGER, INTENT(IN) :: ndims, dims(ndims)
    	LOGICAL, INTENT(IN) :: periods(ndims)
    	INTEGER, INTENT(OUT) :: newrank
    	INTEGER, OPTIONAL, INTENT(OUT) :: ierror
