.. highlight:: c

.. _pragma_memory_partition_argument:

Partition Top-Level Interface
-------------------------------

**Syntax**

``#pragma LEGUP memory partition argument(<arg_name>) dim(<int>)``

**Description**

This pragma specifies a top-level argument to be partitioned. This assumes complete partitioning. Dimension 0 corresponds to the right-most dimension of an array and higher dimensions correspond to leftward dimensions.
Note that this only applies to top level functions.

**Parameters**

+--------------+---------+----------+---------+---------------------+
|  Parameter   | Value   | Optional | Default |     Description     |
+==============+=========+==========+=========+=====================+
| ``argument`` | String  | No       |         | Argument name       |
+--------------+---------+----------+---------+---------------------+
| ``dim``      | Integer | Yes      | 0       | Partition dimension |
+--------------+---------+----------+---------+---------------------+

**Position**

At the beginning of the function definition block.


**Examples**

.. code-block:: c

  int sum(int *a) {
  #pragma LEGUP function top
  #pragma LEGUP memory partition argument(a) dim(0)
  }

--------------------------------------------------------------------------------