.. highlight:: c

.. _pragma_memory_partition_argument:

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

**Syntax**

``#pragma LEGUP memory partition argument(<arg_name>) type(complete|none) dim(<int>)``

**Description**

This pragma specifies a top-level argument to be partitioned. 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       |
+--------------+--------------------+----------+--------------+---------------------+
| ``type``     | ``complete|none``  | Yes      | ``complete`` | Partition type      |
+--------------+--------------------+----------+--------------+---------------------+
| ``dim``      | Integer            | Yes      | 0            | Partition dimension |
+--------------+--------------------+----------+--------------+---------------------+

**Position**

At the beginning of the function definition block.


**Examples**

.. code-block:: c

  int sum(int *a, int *b) {
  #pragma LEGUP function top
  #pragma LEGUP memory partition argument(a) type(none)
  #pragma LEGUP memory partition argument(b)
  }

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